mcp-grok

GrokMCP

AceDataCloud APIを利用した、Grok（xAI）向けのModel Context Protocol（MCP） サーバーです。チャット／推論／ビジョンに加え、Grok Imagineによる動画生成にも対応しています。

MCP対応クライアント（Claude Desktop、Claude Code、Cursorなど）から直接、Grokモデルとチャットしたり、テキストプロンプトや静止画像から短いAI動画を生成したりできます。

機能

• チャット／推論／ビジョン — 画像入力とツール呼び出しに対応したGrok 4.5／Grok 4／Grok 3モデルとの会話
• テキストから動画を生成 — テキストによる説明から動画クリップを生成
• 画像から動画を生成 — 参照画像を動画としてアニメーション化
• 非同期タスクの追跡 — ジョブを送信して結果をポーリング。単一または一括に対応
• stdioおよびHTTPトランスポート — デスクトップクライアント向けのローカルstdio、リモートホスティング向けのHTTP

ツール

ツール	説明
grok_chat_completions	Grokチャットモデルでのチャット補完（推論／ビジョン／ツール呼び出し）。
grok_text_to_video	テキストプロンプトから動画を生成（grok-imagine-video-1.5:officialを除くすべてのモデル）。
grok_image_to_video	入力画像（＋任意の動きのプロンプト）から動画を生成。
grok_get_task	生成タスク単体のステータス／結果を照会。
grok_get_tasks_batch	複数のタスクのステータス／結果を一度に照会。
grok_list_models	利用可能なモデルとその機能を一覧表示。
grok_list_actions	すべてのツールとワークフローの例を一覧表示。
grok_get_prompt_guide	効果的な動画プロンプトを書くためのヒント。

モデル

チャット（grok_chat_completions）

モデル	備考
grok-4.5	デフォルト — 最新のフラッグシップ推論モデル
grok-4	以前のフラッグシップ推論モデル
grok-3	旧世代モデル

動画

モデル	テキスト→動画	画像→動画	備考
grok-imagine-video-1.5-fast:reverse	✅	✅	デフォルト。最速かつ最安。6〜30秒、時間帯別の料金。
grok-imagine-video:reverse	✅	✅	標準。1〜15秒、出力秒数ごとの課金。
grok-imagine-video:official	✅	✅	公式エンドポイント、高忠実度。1〜15秒、秒単位の課金。
grok-imagine-video-1.5:official	❌	✅	公式の画像から動画への変換のみ（image_urlが必要）。最大1080p、秒単位の課金。

パラメーター

パラメーター	対象	値
prompt	両方	テキストによる説明（テキストから動画を生成する場合は必須）
image_url	画像から動画	入力画像のURL（-1.5-previewでは必須）
reference_image_urls	画像から動画	任意のスタイル／コンテンツ参照画像のリスト
aspect_ratio	両方	1:1、16:9（デフォルト）、9:16、4:3、3:4、3:2、2:3
resolution	両方	480p（デフォルト）、720p、1080p
duration	両方	grok-imagine-video-1.5-fast:reverse：6〜30s、その他のモデル：1〜15s（デフォルトは6）
callback_url	両方	任意の非同期Webhook

接続：ホスト型 OAuth、API トークン、またはローカル stdio

ホスト型エンドポイントは https://grok.mcp.acedata.cloud/mcp です。MCP クライアント用に、いずれか1つの方法を選んでください。

方法	使用する場面	認証情報の設定
ホスト型 OAuth	クライアントがリモート MCP OAuth に対応している場合	URL だけを追加し、AceDataCloud にサインインしてアクセスを承認します。クライアント設定にトークンを貼り付ける必要はありません。
ホスト型 API トークン	クライアントで OAuth を完了できない場合、または明示的な連携用認証情報が必要な場合	Authorization: Bearer … ヘッダーで AceDataCloud API トークンを送信します。ローカルのシークレットストアまたは環境変数に保管してください。
ローカル stdio	クライアントがローカルの MCP プロセスを実行する場合	mcp-grok をインストールし、そのプロセスに ACEDATACLOUD_API_TOKEN を渡します。この方法でも AceDataCloud API が呼び出されます。

ホスト型サービスは OAuth メタデータと Dynamic Client Registration（DCR）を公開しています。DCR はクライアントアプリケーションを登録するものであり、API キーではありません。 OAuth でサインインすると、クライアントは発行された Bearer トークンを送信します。また、アカウントの API 認証情報を再利用または作成する場合があります。ブラウザーからサインインするには、引き続き AceDataCloud アカウントが必要です。ホスト型サービスは従量課金の場合があります。実際に操作する前に、現在のサービスドキュメントと表示されている料金を確認してください。同じサーバーに OAuth ログインと固定の Authorization ヘッダーを両方設定しないでください。

ホスト型 OAuth の例

• Claude および Claude Desktop のチャット： Customize → Connectors → Add custom connector でリモートのカスタムコネクターを追加し、https://grok.mcp.acedata.cloud/mcp を入力してサインインを選びます。Claude から OAuth クライアントの登録方法を尋ねられた場合は、Register automatically を選択します。アクセス許可の確認を完了してください。Claude Desktop のローカル claude_desktop_config.json は別途設定が必要です。Claude のコネクターガイド。
• Claude Code： claude mcp add --transport http --scope user grok https://grok.mcp.acedata.cloud/mcp を実行し、続けて claude mcp login grok を実行します。/mcp を確認してください。Claude Code の MCP ガイド。
• Cursor： https://grok.mcp.acedata.cloud/mcp だけを指定してリモートサーバーを追加します。プロジェクトで使う場合は、以下のエントリーを <project>/.cursor/mcp.json に統合します。個人用として使う場合は、~/.cursor/mcp.json を使用します。Cursor の MCP ガイド。
• VS Code / Copilot： MCP: Add Server を実行し、HTTP を選択して https://grok.mcp.acedata.cloud/mcp を入力し、ブラウザーでのサインインを完了します。新しいポータブルなワークスペース設定では <project>/.mcp.json を使用します。以下の VS Code 固有の形式では、<project>/.vscode/mcp.json またはユーザープロファイルを使用します。MCP: List Servers を確認してください。VS Code の MCP セットアップ。
• Codex： codex mcp add grok --url https://grok.mcp.acedata.cloud/mcp を実行し、続けて codex mcp login grok を実行します。ユーザー設定は ~/.codex/config.toml にあります。Codex の公式 MCP ガイド。

Cursor のプロジェクト設定（OAuth）：

{
  "mcpServers": {
    "grok": {"url": "https://grok.mcp.acedata.cloud/mcp"}
  }
}

VS Code 固有のワークスペース設定（OAuth）：

{
  "servers": {
    "grok": {"type": "http", "url": "https://grok.mcp.acedata.cloud/mcp"}
  }
}

ホステッド API トークン

1. Ace Data Cloud → Applications を開きます。サインインするか、先にアカウントを登録してください。
2. General application を探します。まだ作成されていない場合は、Initialize General Application を選択します。汎用キーはアカウントで利用可能なサービスを使用できます。専用アプリケーションのキーは、そのサービスに限定されます。必要なサービス／モデルへのアクセス権と現在の料金を確認してください。
3. アプリケーションカードから API Key をコピーするか、Keys / Manage Keys → Create を開いて、この連携専用のキーを作成します。後から個別に失効またはローテーションできるよう、識別しやすい名前を付けてください。
4. キーを作成するときは、Expiration Time、Set Usage Limitation、Allowed APIs を確認します。必要な制限だけを有効にし、呼び出す操作を許可してから Create をクリックし、キーの一覧からトークンをコピーします。タスクの照会権限では生成の送信は許可されません。最初のリクエストを実行できるだけの残高がアプリケーションにあることを確認してください。トライアル利用枠がある場合、その内容はアカウントに現在表示されているものに準じます。
5. 引用符、空白、Bearer を含めず、トークンの値だけをコピーします。API Key／API Token フィールドにはこの生の値を入力します。手動で設定する HTTP Authorization ヘッダーの場合に限り、Bearer のプレフィックスが必要です。platform-... 形式のアカウント管理トークンを生成 API キーの代わりに使用することはできません。

キーは、クライアントの認証情報ストア、または以下に示す環境変数に保存してください。プロンプト、共有ワークフロー、スクリーンショット、Git のコミットには絶対に含めないでください。認証に失敗した場合は、別のキーを作成する前に、コピーした値全体、アプリケーション／サービスへのアクセス権、有効期限、使用制限、残高を確認してください。

固定の Bearer ヘッダーを使用すると、OAuth がバイパスされます。ヘッダーが無効な場合は、ブラウザーでのサインインを試す前に削除してください。保存した認証情報は非公開にしてください。

Claude Code では、サーバーの追加時にシェルがトークンを展開します。保存されたユーザー MCP 設定は秘密情報として扱ってください。

export ACEDATACLOUD_API_TOKEN='YOUR_API_TOKEN'
claude mcp add --transport http --scope user grok https://grok.mcp.acedata.cloud/mcp \
  --header "Authorization: Bearer $ACEDATACLOUD_API_TOKEN"

Claude Code のプロジェクト設定では、<project>/.mcp.json に変数参照を記述し、Claude Code を起動する環境でその変数を設定します。

{
  "mcpServers": {
    "grok": {
      "type": "http",
      "url": "https://grok.mcp.acedata.cloud/mcp",
      "headers": {"Authorization": "Bearer ${ACEDATACLOUD_API_TOKEN}"}
    }
  }
}

Cursor では、~/.cursor/mcp.json またはコミット対象外のプロジェクト設定で、異なる環境変数構文を使用します。

{
  "mcpServers": {
    "grok": {
      "url": "https://grok.mcp.acedata.cloud/mcp",
      "headers": {"Authorization": "Bearer ${env:ACEDATACLOUD_API_TOKEN}"}
    }
  }
}

VS Code では、MCP: Open User Configuration を実行し、このサーバーとマスクされた入力をマージします。${input:...} は VS Code のユーザー／ワークスペース形式用であり、Agent Host の .mcp.json 形式には移植できません。

{
  "inputs": [
    {"id": "acedata-grok-token", "type": "promptString", "description": "AceDataCloud API token", "password": true}
  ],
  "servers": {
    "grok": {
      "type": "http",
      "url": "https://grok.mcp.acedata.cloud/mcp",
      "headers": {"Authorization": "Bearer ${input:acedata-grok-token}"}
    }
  }
}

Cline では、MCP 設定 UI または CLI ファイル ~/.cline/data/settings/cline_mcp_settings.json を使用します。リモートトランスポート値は streamableHttp です。JetBrains AI Assistant では、Settings → Tools → AI Assistant → Model Context Protocol (MCP) からリモート URL を追加します。Zed では、OAuth を使用する場合は URL のみの context_servers エントリーを設定するか、ローカルの Bearer ヘッダーを追加します。これらのクライアントは設定スキーマがそれぞれ異なります。他のクライアントの JSON をコピーせず、各クライアントの現在の UI に従ってください。Cline · JetBrains · Zed。

ローカル stdio

パッケージをインストールし、ローカルプロセスに API トークンを渡します。

python -m pip install mcp-grok
export ACEDATACLOUD_API_TOKEN='YOUR_API_TOKEN'
mcp-grok

Claude Desktop のローカル MCP では、開発者設定から開くファイル（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json）にこのエントリーをマージします。uvx を使用するには、uv が PATH に設定されている必要があります。

{
  "mcpServers": {
    "grok": {
      "command": "uvx",
      "args": ["mcp-grok"],
      "env": {"ACEDATACLOUD_API_TOKEN": "YOUR_API_TOKEN"}
    }
  }
}

このユーザーレベルのファイルは非公開にしてください。セルフホストの HTTP では mcp-grok --transport http --port 8000 を使用し、適切なネットワーク制御と TLS 制御を行った場合に限り公開してください。ローカルで実行する場合も、AceDataCloud API が呼び出されます。

サービスを利用する前の確認

1. https://grok.mcp.acedata.cloud/health が {"status":"ok"} を返すことから確認できるのは、エンドポイントに到達できることだけです。
2. MCP クライアントがツールを読み込むことを確認します。grok_list_models は参照用ツールであり、下流 API へのアクセスや残高は確認しません。
3. API を完全に確認する必要がある場合は、最新のサービスドキュメントと表示価格を確認したうえで、有効な独自の入力を使って grok_chat_completions を呼び出します。結果にタスク ID が含まれている場合は、終端状態で成功または失敗が確認できるまで、同じ ID に対して grok_get_task を呼び出します。進行状況を確認するためだけに操作を再送信しないでください。

401 が返された場合は、クライアントが使用した認証方式と、トークンまたは OAuth セッションが有効かどうかを確認してください。403 は、アカウントの権限エラーまたはコンテンツモデレーションの失敗を示している可能性があります。返されたエラーを確認してください。残高不足と下流サービスの障害は、それぞれ個別に診断する必要があります。ツールが一覧表示されていることや、タスクが送信されたことだけでは、結果が成功したとは限りません。

開発

pip install -e ".[dev,test]"
pytest --cov=core --cov=tools
ruff check .

ドキュメント

ドキュメント

ライセンス

MIT — LICENSE を参照してください。