Grok-MCP

エージェントによるツール呼び出し、画像・動画生成、ビジョン、ファイルサポートを備えたxAIのGrok API用MCPサーバー。

機能

エージェントによるツール呼び出し: Web検索、X検索、およびマルチステップ推論を伴うコード実行
複数のGrokモデル: grok-4.20-0309-reasoning、grok-4-1-fast-reasoningなどの最新モデルへのアクセス
画像および動画生成: Grok Imagineを使用した画像と動画の作成
ビジョン機能: Grokのビジョンモデルによる画像解析
Files API: ドキュメントのアップロード、管理、およびチャット
ステートフルな会話: 複数のリクエスト間で会話コンテキストをIDとして保持
ローカルチャット履歴: クライアント側のチャット履歴を chats/ 内のJSONファイルとして永続的に保存するオプション

Related MCP server: Zen MCP Server

前提条件

Python 3.11以上
xAI APIキー (こちらから取得)
Astral UV

インストール

リポジトリをクローンします:

git clone https://github.com/merterbak/Grok-MCP.git
cd Grok-MCP

venv環境を作成します:

uv venv
source .venv/bin/activate # macOS/Linux or .venv\Scripts\activate on Windows

依存関係をインストールします:

uv sync

設定

Claude Desktopとの統合

Claude Desktopの設定ファイルに以下を追加します:

{
  "mcpServers": {
    "grok": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/Grok-MCP",
        "run",
        "python",
        "main.py"
      ],
      "env": {
        "XAI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Codeとの統合

プロジェクトディレクトリ内で以下のコマンドを実行します:

claude mcp add grok-mcp -e XAI_API_KEY=your_api_key_here -- uv run --directory /path/to/Grok-MCP python main.py

または、キーを含む .env ファイルがある場合は以下を実行します:

 claude mcp add grok-mcp -- uv run --directory /path/to/Grok-MCP python main.py

登録されていることを確認します:

claude mcp list

Filesystem MCP (オプション)

Claude Desktopは、チャットでアップロードされた画像をMCPツールに送信できません。コンピュータ上のファイルに直接アクセスできるようにする最も簡単な方法は、公式のFilesystem MCPサーバーを使用することです。セットアップ後、チャットで画像のファイルパス（例: /Users/mert/Desktop/image.png）を入力するだけで、Claudeが任意のビジョンチャットツールで使用できるようになります。

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/<your-username>/Desktop",
        "/Users/<your-username>/Downloads"
      ]
    }
  }
}

stdioの場合:

uv run python main.py

Dockerの場合:

docker compose up --build

Mcp Inspectorの場合:

mcp dev main.py

利用可能なツール

各ツールには、引数と戻り値の形式が記載された完全なドキュメント文字列が src/server.py にあります。MCPクライアントはこれらを直接表示するため、このリストは利用可能なものの簡単なマップです。

注: 画像やファイルを使用するには、チャットへのパスを提供する必要があります。セットアップについては Filesystem MCP (オプション) を参照してください。

チャットと推論

chat — オプションの永続的な履歴とマルチエージェントサポートを備えた標準的なチャット補完。
chat_with_vision — Grokビジョンモデルを使用してローカルまたはリモートの画像を解析します。
chat_with_files — 以前にアップロードされたドキュメントに基づいたチャット。
stateful_chat — response_id を介してサーバー側に保存された会話を継続します。
retrieve_stateful_response — IDによって保存された応答を取得します。
delete_stateful_response — IDによって保存された応答を削除します。

エージェントツール

web_search — ドメインフィルターと引用を備えた自律的なWebリサーチ。
x_search — ハンドルと日付フィルターを備えた、X (Twitter) 投稿に対する自律的な検索。
code_executor — サンドボックス内でPythonを実行してタスクを解決します。
grok_agent — ファイル、画像、Web検索、X検索、コード実行を組み合わせた統合エージェント。

画像と動画

generate_image — Grok Imagineを使用して画像を作成または編集します（複数参照編集をサポート）。
generate_video — Grok Imagineを使用したテキストから動画、画像から動画、または動画編集。
extend_video — フォローアッププロンプトを使用して、生成済みの動画を拡張します。

ファイル

upload_file — ローカルドキュメントをアップロードします。
list_files — ソート機能付きでアップロードされたファイルを一覧表示します。
get_file — IDによってファイルのメタデータを取得します。
get_file_content — ファイルの内容をテキストとしてダウンロードします。
delete_file — IDによってファイルを削除します。

ローカルチャット履歴

list_chat_sessions — chats/ に保存されたセッションを一覧表示します。
get_chat_history — セッションの完全なトランスクリプトを取得します。
clear_chat_history — セッションのローカル履歴ファイルを削除します。

モデル

list_models — ライブ価格情報を含むすべてのGrok言語モデルおよび画像モデルを一覧表示します。

ライセンス

このプロジェクトはオープンソースであり、MITライセンスの下で利用可能です。

Grok MCP