flux-mcp

RunAPI Flux MCP サーバー

AI エージェント向けの Flux API アクセス：画像生成処理の実行、非同期結果のポーリング、料金の確認を、用途に特化した 1 つの MCP サーバーで行えます。

_{Claude Code、Codex、Cursor、Windsurf、VS Code、Roo Code、および MCP 互換のすべてのホストで動作します。}

インストール | ツール | モデル | エージェントのプロンプト | 設定 | リンク

---

このパッケージを使う理由

@runapi.ai/flux-mcp は、RunAPI の Flux モデル群に特化した Model Context Protocol サーバーです。 MCP 互換のアシスタントから、RunAPI の全カタログを読み込まずに 2 つのエンドポイントと 3 種類のモデルを直接利用できます。

エージェントの対象を Flux に限定する場合は、このモデル別サーバーをお使いください。1 つのアシスタントから RunAPI のすべてのモデル群を検出できるようにするには、@runapi.ai/mcp をお使いください。

---

インストール

Claude Code に追加します：

claude mcp add flux -s user -- npx -y @runapi.ai/flux-mcp

サーバーをリポジトリ内で共有する場合は、プロジェクトスコープを使います：

claude mcp add flux -s project -- npx -y @runapi.ai/flux-mcp

Codex、Cursor、Windsurf、VS Code、Roo Code、およびその他の MCP ホストでは、同じ stdio コマンドを使用できます：

{
  "mcpServers": {
    "flux": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/flux-mcp"]
    }
  }
}

check_pricing はサインイン前でも使用できます。タスクの作成とステータスのポーリングには、アシスタントに login ツールを呼び出すよう依頼してください。ブラウザーでログインが開始され、runapi login と同じ ~/.config/runapi/config.json に認証情報が保存されます。 ヘッドレス環境や CI ホストでも、MCP ホストの起動前に RUNAPI_API_KEY を設定して使用できます。

Claude、Cursor、Windsurf、VS Code、Roo Code 向けのすぐに使える例は、examples/ にあります。

---

ツール

ツール	認証	用途
remix_image	必要	Flux のリミックス画像タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
text_to_image	必要	Flux のテキストから画像を生成するタスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
get_task	必要	既存タスクの現在のステータスと最新のペイロードを取得します。
check_pricing	不要	Flux のモデルとエンドポイントの現在の料金を確認します。

---

モデル

Flux では、2 つのエンドポイントにわたって 3 種類のモデルを利用できます。各ツールで、対応するモデルを指定できます：

ツール	モデル
remix_image	flux-dev、flux-pro
text_to_image	flux-2-klein、flux-dev、flux-pro

モデルの提供状況はリリースごとに変わる可能性があります。最新のカタログを確認するには、check_pricing またはFlux モデルページをご利用ください。

---

エージェントのプロンプト

自然な言葉でアシスタントに依頼できます。料金の確認、タスクの作成を行い、タスク ID と出力 URL を返します。

タスクを作成する

Run a Flux remix image task with RunAPI.

アシスタントは check_pricing を呼び出してから remix_image を呼び出し、タスク ID、ステータス、出力 URL を返します。

待機せずに送信する

Create the task but don't wait for it to finish.

アシスタントは wait: false を指定して作成ツールを呼び出し、タスク ID を返します。後で get_task を使って状況を確認できます。

作成前に料金を確認する

Check current Flux pricing, then create the task if it matches my request.

アシスタントは check_pricing を呼び出し、正規のカタログ情報としてFlux モデルページへのリンクを提示できます。

---

設定

サーバーは次の順序で認証情報を解決します。

1. RUNAPI_API_KEY 環境変数。ヘッドレス環境や CI ホストで便利です。
2. ~/.config/runapi/config.json。MCP の login ツールまたは runapi login によって作成されます。
3. キーなし。この場合でも check_pricing は使用できます。

設定ファイルは通常、ログインによって管理されます。事前に設定されたヘッドレス環境の設定には、次を使用できます。

{
  "apiKey": "your_runapi_key"
}

実際の API キーをコミットしないでください。

---

リンク

リソース	URL
Flux モデルページ	https://runapi.ai/models/flux
npm パッケージ	@runapi.ai/flux-mcp
GitHub リポジトリ	runapi-ai/flux-mcp
RunAPI MCP の概要	runapi.ai/mcp
RunAPI ドキュメント	runapi.ai/docs

---

ライセンス

Apache License, Version 2.0 のもとでライセンスされています。