grok-imagine-mcp

RunAPI Grok Imagine MCP サーバー

AI エージェント向けの Grok Imagine API アクセス：画像・動画の生成処理を実行し、非同期処理の結果をポーリングし、料金を確認できる、用途を絞った MCP サーバーです。

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

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

---

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

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

エージェントの利用範囲を Grok Imagine に限定する場合は、このモデル専用サーバーを使用してください。1 つのアシスタントから RunAPI のすべてのモデル系列を検索する場合は、@runapi.ai/mcp を使用してください。

---

インストール

Claude Code に追加します：

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

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

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

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

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

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

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

---

ツール

ツール	認証	用途
edit_image	はい	Grok Imagine の画像編集タスクを作成し、任意で終了ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
extend_video	はい	Grok Imagine の動画延長タスクを作成し、任意で終了ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
image_to_video	はい	Grok Imagine の画像から動画への変換タスクを作成し、任意で終了ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
segment_map	はい	Grok Imagine のセグメントマップタスクを作成し、任意で終了ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
text_to_image	はい	Grok Imagine のテキストから画像への変換タスクを作成し、任意で終了ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
text_to_video	はい	Grok Imagine のテキストから動画への変換タスクを作成し、任意で終了ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
upscale_image	はい	Grok Imagine の画像アップスケールタスクを作成し、任意で終了ステータスまで待機します。タスク ID、ステータス、出力 URL を返します。
get_task	はい	既存のタスクについて、現在のステータスと最新のペイロードを取得します。
check_pricing	いいえ	Grok Imagine のモデルとエンドポイントの現在の料金を確認します。

---

モデル

Grok Imagine は 7 つのエンドポイントで 7 種類のモデルを提供します。各ツールで指定できるモデルは次のとおりです。

ツール	モデル
edit_image	grok-imagine-edit-image、grok-imagine-image-2-0
extend_video	モデルパラメーターなし
image_to_video	grok-imagine-image-to-video、grok-imagine-video-1.5-fast、grok-imagine-video-1.5-preview
segment_map	grok-imagine-image-2-0
text_to_image	grok-imagine-image-2-0、grok-imagine-text-to-image
text_to_video	grok-imagine-text-to-video、grok-imagine-video-1.5-fast、grok-imagine-video-1.5-preview
upscale_image	モデルパラメーターなし

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

---

エージェント向けプロンプト

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

タスクを作成する

Run a Grok Imagine edit image task with RunAPI.

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

待たずに送信する

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

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

作成前に料金を確認する

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

アシスタントは check_pricing を呼び出し、正規のカタログ情報を確認できる Grok Imagine のモデルページ へのリンクを案内します。

---

設定

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

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

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

{
  "apiKey": "your_runapi_key"
}

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

---

リンク

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

---

ライセンス

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