Flux Cloud

Flux Cloud MCP サーバー

あらゆる AI エージェントが、分散型クラウドである Flux Cloud を利用できるようにする MCP サーバーです。アプリの米ドル建て見積もり、デプロイ、支払い、起動状況の確認、ログの閲覧、更新、キャンセルができます。Claude Code、Claude Desktop、Cursor、Windsurf、OpenCode、およびその他すべての MCP ホストで動作します。

アカウントは不要です。2 つのキーだけで、すべての識別が完結します。

キー	アドレス	役割
FLUX_ID_PRIVATE_KEY	Flux ID、1...	アプリを所有します。仕様と API セッションに署名します。資金は保持しません。
FLUX_PAYMENT_PRIVATE_KEY	Flux アドレス、t1...	FLUX を保持し、オンチェーンでデプロイ料金を支払います。

サーバーがキーのペアを生成します（flux_generate_keys）。支払い用アドレスに FLUX を入金して、デプロイしてください。

料金ポリシー

このサーバーが表示する料金はすべて、home.runonflux.io が請求するものと同じ Flux Cloud の米ドル建て価格です。これを、FLUX で支払う場合の 5％割引を適用したリアルタイムの市場レートで FLUX に換算しています。見積もりはネットワーク自体（/apps/calculatefiatandfluxprice）から取得するため、0.99 ドルの最低料金、ハードウェア割引、期間割引、更新クレジットが反映されます。

ブロックチェーン独自の受け入れしきい値は、これより数倍低く設定されています。これは価格として表示されることはなく、支払いのブロードキャスト前にガードとして確認されるだけです。

インストール

npm install -g @runonflux/flux-cloud-mcp     # or: yarn global add @runonflux/flux-cloud-mcp

または、インストールせずに実行できます：npx @runonflux/flux-cloud-mcp。

Claude Code

claude mcp add flux-cloud -s user \
  -e FLUX_ID_PRIVATE_KEY=<wif> -e FLUX_PAYMENT_PRIVATE_KEY=<wif> \
  -- npx -y @runonflux/flux-cloud-mcp

Claude Desktop、Cursor、Windsurf（JSON 設定）

{
  "mcpServers": {
    "flux-cloud": {
      "command": "npx",
      "args": ["-y", "@runonflux/flux-cloud-mcp"],
      "env": {
        "FLUX_ID_PRIVATE_KEY": "<wif of the Flux ID>",
        "FLUX_PAYMENT_PRIVATE_KEY": "<wif of the payment address>"
      }
    }
  }
}

キーは省略可能です。キーがなくてもすべての読み取り専用ツールが動作し、flux_generate_keys を使って設定に追加するキーのペアを作成できます。

OpenCode

{
  "mcp": {
    "flux-cloud": {
      "type": "local",
      "command": ["npx", "-y", "@runonflux/flux-cloud-mcp"],
      "environment": {
        "FLUX_ID_PRIVATE_KEY": "<wif>",
        "FLUX_PAYMENT_PRIVATE_KEY": "<wif>"
      }
    }
  }
}

ツール

ツール	機能	FLUXを消費
flux_get_identity	Flux ID、支払いアドレス、FLUX および USD での残高	いいえ
flux_generate_keys	新しい Flux ID と支払い用キーのペア、およびセットアップ手順	いいえ
flux_get_pricing	USD 料金表、FLUX/USD レート、割引、参考サイズ	いいえ
flux_build_spec	簡単な説明（イメージ、ポート、CPU/RAM/HDD、月数）から完全な v8 仕様を作成	いいえ
flux_validate_spec	ローカルルールに加え、FluxOS ノードで検証	いいえ
flux_quote_app	登録または更新に必要な USD 価格と支払い額（FLUX）	いいえ
flux_deploy_app	デフォルトではプランを作成し、confirm=true の場合は署名、ブロードキャスト、支払いを実行	confirm 指定時
flux_wait_for_app	承認され、インスタンスが実行されるまでポーリングし、URL を返す	いいえ
flux_get_app	任意のアプリの仕様、有効期限、インスタンス、URL	いいえ
flux_list_my_apps	Flux ID が所有するアプリと、インスタンス数および残り日数	いいえ
flux_get_app_logs	実行中のインスタンスのコンテナログ（所有者のみ）。コンポーネントは自動選択され、プライベートアプリは所有者キーで復号されます	いいえ
flux_get_app_stats	インスタンスの CPU、メモリ、ネットワークのリアルタイム情報（所有者のみ）	いいえ
flux_control_app	ノード単位またはグローバルに、インスタンスを再起動、再デプロイ、または削除	いいえ
flux_cancel_app	契約期間を短縮してアプリを早期終了	confirm 指定時
flux_get_network_info	ノード数、高さ、FLUX/USD、デプロイアドレス	いいえ

リソース flux://guide/overview、flux://guide/spec-format、 flux://guide/pricing、flux://guide/gotchas がエージェントにドメイン知識を提供し、 deploy_on_flux プロンプトがデプロイの手順を案内します。

一般的なセッション

> deploy nginx on flux, 3 instances, one month

flux_get_identity      -> Flux ID 1Ab..., payer t1Cd..., 996.98 FLUX ($48.74)
flux_build_spec        -> v8 spec, port 39978 -> 80, r:/data, valid
flux_quote_app         -> $0.99 for 1 month, pay 19.24 FLUX (5% FLUX discount)
   user agrees
flux_deploy_app confirm=true
                       -> message hash 8d2f..., paid 19.24 FLUX, txid 0c41...
flux_wait_for_app      -> accepted at height 2941560, 3/3 instances running
                          https://myapp.app.runonflux.io

デプロイの仕組み

1. 登録時とまったく同じように、api.runonflux.io を通じて仕様を検証します（イメージに到達できること、アーキテクチャ、ポート、名前が未使用であること）。ロードバランサーが拒否した場合は、稼働中のノードをいくつか調べ、順番に試します。
2. ネットワークが USD での価格を提示し、サーバーが支払者の残高を確認します。
3. confirm=true の場合、Flux ID が仕様に署名し、同じエンドポイントからネットワークにブロードキャストして、64 文字のメッセージハッシュを返します。
4. 支払いアドレスから、OP_RETURN 出力にハッシュを含めて、提示された FLUX をネットワークのデプロイ用アドレスに送信します。署名の直前に、最新の価格表を取得して金額を再確認します。支払い額が不足したメッセージは通知なく破棄され、FLUX も返金されないためです。
5. ノードが確認済みの支払いとメッセージを照合し、アプリを公開します。その後、インスタンスが起動してイメージをプルします。

プライベート（エンタープライズ）アプリは空のコンポーネントリストを公開するため、所有者キーが設定されているか渡された場合、flux_get_app、flux_get_app_logs、flux_get_app_stats は ArcaneOS ノードから復号済みの仕様を取得します。返されるのはコンポーネント名、イメージ、ポート、サイズのみです。環境変数、コマンド、レジストリの認証情報がサーバーの外部に出ることはありません。

更新にも同じツールを使用します。同じ所有者の既存アプリには fluxappupdate メッセージが送信され、ネットワークが以前の期間の未使用分をクレジットします。プライベート（エンタープライズ）アプリは enterprise 引数を通じてサポートされています。コンポーネントはネットワーク向けに暗号化され、実行できるのは ArcaneOS ノードのみです。

ホスト型サーバー：mcp.runonflux.com

同じサーバーは Flux Cloud 上でも Streamable HTTP 経由で稼働しています。ローカルプロセスを起動できないホスト（claude.ai コネクター、ChatGPT、ブラウザーやモバイルのエージェント）向けです。リモート MCP サーバーとして追加します。

https://mcp.runonflux.com/mcp   (also https://mcp.runonflux.io/mcp)

ホスト型サーバーはキーを保持しません。読み取り専用ツールにはキーは不要です。署名や支払いを行うツールでは、呼び出し引数として fluxIdPrivateKey と paymentPrivateKey を受け取り、その呼び出しの間だけメモリ上で使用します。ログに記録したり保存したりすることはありません。サーバーの指示では、flux_generate_keys で専用のキーのペアを作成し、ほかの場所で使用しているウォレットのキーを求めるのではなく、デプロイに必要な分だけユーザーに入金してもらうようエージェントに伝えています。チャットに入力された内容は AI ベンダーとホストの履歴を通過するため、このキーのペアは使い捨てとして扱い、残高を少額に保ってください。より大きな予算を扱う場合は、キーがマシンの外部に出ないローカルサーバーを実行してください。

Docker で独自のコピーを実行します。

docker run -p 3000:3000 runonflux/flux-cloud-mcp

ステートレスなので、任意の数のインスタンスを 1 つのロードバランサーの背後に配置できます。GET /healthz は稼働状況を報告します。パブリックインスタンスを実行する Flux アプリの仕様は deploy/cloudmcp.json にあります。

設定

変数	デフォルト	用途
FLUX_ID_PRIVATE_KEY		Flux ID（所有者）の WIF
FLUX_PAYMENT_PRIVATE_KEY		支払いアドレスの WIF
FLUX_API_URL	https://api.runonflux.io	読み取りと価格提示に使用するロードバランス済み FluxOS API
FLUX_NODE_URL	auto	登録用に FluxOS ノードを 1 つ指定
FLUX_EXPLORER_URLS	explorer.runonflux.io,flux-explorer.sspwallet.io	UTXO とブロードキャスト用の Insight エクスプローラー
FLUX_STATS_URL	https://stats.runonflux.io	USD 料金表
FLUX_RATES_URL	https://viprates.runonflux.io	FLUX の市場レート

セキュリティに関する注意事項

• 秘密鍵はサーバープロセス内に保持されます。設定済みの鍵を返すツールはありません。flux_generate_keys が返すのは、新たに作成した鍵のみです。
• ツールの呼び出し時に confirm=true を指定しない限り、費用は発生しません。ツール呼び出しの前に確認を求めるホストでは、引数のコンテキストに USD 建ての金額が表示されます。
• FluxOS のセッションは、数時間有効な、署名付きの自己発行フレーズです。パスワードやトークンはどこにも保存されません。
• 支出予定額だけを保有する専用の支払いアドレスを使用してください。

開発

yarn install
yarn type-check && yarn lint && yarn format:check && yarn build && yarn test
yarn test:live      # differential test of the USD estimator against the network

USD 見積もり機能、仕様フォーマッター、コンセンサスガードは FluxOS のコード（appSpecHelpers.js、appUtilities.js、messageVerifier.js）を反映しています。また、ライブテストでは実行のたびに見積もりをネットワークと照合します。

ライセンス

MIT