flux-2-mcp

RunAPI Flux 2 MCP サーバー

AI エージェント向けの Flux 2 API アクセス：専用の MCP サーバーを通じて、画像生成の操作、非同期結果のポーリング、料金の確認を行えます。

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

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

---

このパッケージを選ぶ理由

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

エージェントの対象を Flux 2 に限定する場合は、このモデル専用サーバーを使用してください。1 つのアシスタントで RunAPI のすべてのモデル系列を検出する場合は、@runapi.ai/mcp を使用してください。

---

インストール

Claude Code に追加します：

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

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

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

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

{
  "mcpServers": {
    "flux-2": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/flux-2-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 2 のリミックス画像タスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
text_to_image	必要	Flux 2 のテキストから画像を生成するタスクを作成し、必要に応じて最終ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
get_task	必要	既存のタスクの現在のステータスと最新のペイロードを取得します。
check_pricing	不要	Flux 2 のモデルとエンドポイントの現在の料金を調べます。

---

モデル

Flux 2 は、2 つのエンドポイントで 6 種類のモデルを提供します。各ツールでは、そのツールに対応するモデルを指定できます：

ツール	モデル
remix_image	flux-2-flex-remix-image、flux-2-max-remix-image、flux-2-pro-remix-image
text_to_image	flux-2-flex-text-to-image、flux-2-max-text-to-image、flux-2-pro-text-to-image

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

---

エージェントプロンプト

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

タスクを作成する

Run a Flux 2 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 2 pricing, then create the task if it matches my request.

アシスタントはcheck_pricingを呼び出し、正規のカタログエントリとしてFlux 2 model pageにリンクできます。

---

設定

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

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

設定ファイルは通常、ログインによって管理されます。事前にプロビジョニングされたヘッドレス用設定では、次のように指定できます。

{
  "apiKey": "your_runapi_key"
}

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

---

リンク

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

---

ライセンス

Apache License, Version 2.0に基づいてライセンスされています。