grok-bot-mcp

Grok Bot 用 MCP サーバー — あらゆる AI エージェントからボットを操作できます。

ボットの作成、トランスクリプトの読み取り、メッセージの送信、履歴の検索、使用量の確認まで、すべて Model Context Protocol を通じて実行できます。Claude Desktop、Cursor、Windsurf、Cline、VS Code Copilot、その他 MCP 互換クライアントで動作します。

関連プロジェクト: gbu — Grok Bot 使用量チェッカー

これは何か

grok-bot-mcp は、AI エージェント（Claude、Cursor、Copilot など）とローカルで実行中の Grok Bot インスタンスを橋渡しする MCP サーバーです。インストールすると、MCP 互換の AI クライアントから以下が可能になります:

• ボットの作成・一覧表示・検索・削除 — Grok Bot アプリを開く必要なし

• ボットへのメッセージ送信と応答の取得 — AI エディタから直接実行

• 会話トランスクリプトの読み取り — 任意のボットの完全な履歴

• 全ボットメッセージの横断検索 — ローカルデータベースに対する全文検索

• 使用量と請求の確認 — 週間使用率、オンデマンド支出、リセット時間

• ローカルデータベースの一覧表示 — すべてのエージェント store.db ファイルとそのサイズ

すべて標準化された MCP ツールインターフェースを通じて実行されます。カスタム API 統合は不要です。

Related MCP server: Grok MCP

インストール

1コマンド（macOS / Linux）:

gh repo clone Kargatharaakash/grok-bot-mcp && cd grok-bot-mcp && sh install.sh

インストールスクリプトは、インストール済みの AI エージェントを自動検出し、それぞれに対して MCP サーバーを設定します。インストール後は AI エージェントを再起動してください。

設定される内容:

ツール

MCP サーバーは、接続された任意の AI エージェントに以下のツールを公開します:

エージェント管理

メッセージング

データベース

使用量

仕組み

AI Agent (Claude / Cursor / Copilot / Windsurf / etc.)
        │
        │ MCP Protocol (JSON-RPC over stdio)
        ▼
   grok-bot-mcp server
        │
        ├── Grok Bot Gateway ──► http://127.0.0.1:<port>/api/<command>
        │                          ├── listAgents, createAgent, sendPrompt...
        │                          └── 100+ gateway commands
        │
        ├── Local SQLite DBs ──► ~/.grokbot/agents/<id>/store.db (read-only)
        │                          └── transcript_entries, kv, blobs
        │
        └── Cursor Usage API ─► api2.cursor.sh (ConnectRPC)
                                   └── GetSandUsageStatus, GetCurrentPeriodUsage

サーバーは gateway-descriptor.json を復号して Grok Bot ゲートウェイを検出します（gbu と同じ macOS Keychain 方式）。データベースクエリでは、ローカルの SQLite ファイルを読み取り専用モードで直接読み取ります。

手動設定

手動で設定する場合は、MCP 設定ファイルに以下を追加してください:

{
  "mcpServers": {
    "grok-bot": {
      "command": "node",
      "args": ["~/.gbm/bin/grok-bot-mcp"]
    }
  }
}

要件

• Node.js 18+

• Grok Bot アプリがインストールされ実行中であること（ゲートウェイとキーチェーンアクセス用）

• macOS（ゲートウェイ検出とキーチェーン復号用。データベース読み取りはファイルが存在すれば任意の OS で動作）

テスト

テストはモックを使用します — 実際の Grok Bot 呼び出し、ネットワーク、データベース書き込みは一切ありません:

node --test tests/*.test.mjs

セキュリティ

• 読み取り専用のデータベースアクセス — すべての SQLite クエリで PRAGMA query_only = 1 を設定

• MCP 応答にシークレットを含めない — トークンが AI エージェントに返されることはありません

• ゲートウェイトークンは起動時に復号 — ディスクに書き込まれることはありません

• ローカルのみ — stdio トランスポート、ネットワークサーバーは公開しません

• テレメトリなし — 127.0.0.1（ゲートウェイ）と api2.cursor.sh（使用量）以外への呼び出しはゼロ

アンインストール

rm -rf ~/.gbm

その後、AI エージェントの MCP 設定ファイルから grok-bot エントリを削除してください。

関連プロジェクト

gbu — Grok Bot 使用量チェッカー CLI。ターミナルから複数アカウントの使用量を確認できます。同じトークン管理、同じ API、異なるインターフェース（CLI と MCP）。

ライセンス

MIT

#GrokBot #MCP #ModelContextProtocol #Cursor #Claude #AI #DeveloperTools #Automation

⭐ このプロジェクトで AI エージェントがボットを操作できるようになったら、スターをお願いします。

免責事項

このプロジェクトは、学習および研究目的で作成された独立した教育用ツールです。 Cursor、Anysphere、Grok、Grok Bot、SpaceXAI、 xAI、SpaceX、その他いかなる企業、製品、団体とも提携、推薦、スポンサー関係、関連はありません。

このリポジトリで言及されているすべての製品名、ロゴ、商標、登録商標は、 それぞれの所有者に帰属します。名称やロゴの使用は識別および教育的参照のみを目的としており、 推薦、パートナーシップ、提携を意味するものではありません。

このツールは、ローカルで実行中のアプリケーションと公開 API エンドポイントに、 ユーザーがすでに保有する認証情報を使用してアクセスします。認証を回避したり、 保護されたコンテンツをスクレイピングしたり、非公開システムにアクセスしたりすることはありません。 このツールを利用するプラットフォームの利用規約を遵守する責任はすべてユーザーにあります。

このプロジェクトの作者および貢献者は、本ソフトウェアの使用から生じるいかなる損害、 アカウントへの措置、結果についても責任を負いません。自己の判断で使用してください。