imagen-4-mcp

RunAPI Imagen 4 MCP サーバー

AI エージェントから Imagen 4 API にアクセスできます。画像生成タスクの実行、非同期結果の確認、料金の照会を、専用の MCP サーバーひとつで行えます。

_{Claude Code、Codex、Cursor、Windsurf、VS Code、Roo Code、および MCP 互換ホストで利用できます。}

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

---

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

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

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

---

インストール

Claude Code に追加します。

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

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

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

Codex、Cursor、Windsurf、VS Code、Roo Code などの MCP ホストでも、同じ stdio コマンドを使用できます。

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

---

モデル

Imagen 4 には、2 つのエンドポイントにわたって 4 種類のモデルがあります。各ツールで、対応するモデルを指定できます。

ツール	モデル
remix_image	imagen-4-pro-remix-image
text_to_image	imagen-4、imagen-4-fast、imagen-4-ultra

モデルの提供状況はリリースごとに変更される場合があります。最新のカタログを確認するには、check_pricing または Imagen 4 モデルページ を使用してください。

---

エージェントプロンプト

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

タスクを作成する

Run an Imagen 4 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 Imagen 4 pricing, then create the task if it matches my request.

アシスタントはcheck_pricingを呼び出し、正式なカタログ項目としてImagen 4 のモデルページへのリンクを提示できます。

---

設定

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

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

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

{
  "apiKey": "your_runapi_key"
}

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

---

リンク

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

---

ライセンス

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