grok-bot-mcp

MCP-сервер для Grok Bot — позвольте любому ИИ-агенту управлять вашими ботами.

Создавайте ботов, читайте транскрипты, отправляйте сообщения, ищите в истории и проверяйте использование — всё через Model Context Protocol. Работает с Claude Desktop, Cursor, Windsurf, Cline, VS Code Copilot и любым MCP-совместимым клиентом.

Компаньон: gbu — проверка использования Grok Bot

Что это делает

grok-bot-mcp — это MCP-сервер, который связывает ИИ-агентов (Claude, Cursor, Copilot и т.д.) с вашим локально запущенным экземпляром Grok Bot. После установки любой MCP-совместимый ИИ-клиент может:

• Создавать, перечислять, искать и удалять ботов — не открывая приложение Grok Bot

• Отправлять сообщения ботам и получать ответы — прямо из вашего ИИ-редактора

• Читать транскрипты разговоров — полную историю любого бота

• Искать по всем сообщениям ботов — полнотекстовый поиск по локальным базам данных

• Проверять использование и биллинг — еженедельное использование %, расходы по требованию, время сброса

• Список локальных баз данных — просмотр всех файлов store.db агентов и их размеров

Всё через стандартизированный интерфейс инструментов MCP. Никакой кастомной интеграции API не требуется.

Related MCP server: Grok MCP

Установка

Одна команда (macOS / Linux):

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

Скрипт установки автоматически определяет, какие ИИ-агенты у вас установлены, и настраивает MCP-сервер для каждого из них. Перезапустите вашего ИИ-агента после установки.

Что он настраивает:

Инструменты

MCP-сервер предоставляет эти инструменты любому подключённому ИИ-агенту:

Управление агентами

Обмен сообщениями

База данных

Использование

Как это работает

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

Сервер обнаруживает шлюз Grok Bot, расшифровывая gateway-descriptor.json (та же техника с macOS Keychain, что и в gbu). Для запросов к базе данных он напрямую читает локальные файлы SQLite в режиме только для чтения.

Ручная настройка

Если вы предпочитаете настроить вручную, добавьте это в ваш файл конфигурации MCP:

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

Требования

• Node.js 18+

• Приложение Grok Bot установлено и запущено (для доступа к шлюзу и связке ключей)

• macOS (для обнаружения шлюза и расшифровки связки ключей; чтение базы данных работает на любой ОС, если файлы существуют)

Тестирование

Тесты используют моки — никаких реальных вызовов Grok Bot, сети или записи в базу данных:

node --test tests/*.test.mjs

Безопасность

• Доступ к базе данных только для чтения — PRAGMA query_only = 1 для всех SQLite-запросов

• Никаких секретов в ответах MCP — токены никогда не возвращаются ИИ-агенту

• Токен шлюза расшифровывается при запуске — никогда не записывается на диск

• Только локально — stdio-транспорт, сетевой сервер не открывается

• Никакой телеметрии — ноль вызовов, кроме 127.0.0.1 (шлюз) и api2.cursor.sh (использование)

Удаление

rm -rf ~/.gbm

Затем удалите запись grok-bot из файла конфигурации MCP вашего ИИ-агента.

Сопутствующий проект

gbu — CLI для проверки использования Grok Bot. Проверка использования нескольких аккаунтов из терминала. То же управление токенами, тот же API, другой интерфейс (CLI против MCP).

Лицензия

MIT

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

⭐ Поставьте звезду, если это позволило вашему ИИ-агенту управлять вашими ботами.

Отказ от ответственности

Этот проект — независимый образовательный инструмент, созданный для обучения и исследовательских целей. Он не связан, не одобрен, не спонсируется и не ассоциирован с Cursor, Anysphere, Grok, Grok Bot, SpaceXAI, xAI, SpaceX или любой другой компанией, продуктом или организацией.

Все названия продуктов, логотипы, товарные знаки и зарегистрированные товарные знаки, упомянутые в этом репозитории, являются собственностью их соответствующих владельцев. Использование любых названий или логотипов предназначено только для идентификации и образовательных ссылок и не подразумевает одобрения, партнерства или принадлежности.

Этот инструмент взаимодействует с локально запущенными приложениями и публично доступными API-эндпоинтами, используя учетные данные, которые у вас уже есть. Он не обходит аутентификацию, не извлекает защищенный контент и не получает доступ к непубличным системам. Вы несете единоличную ответственность за соблюдение Условий предоставления услуг любой платформы, которую вы используете с этим инструментом.

Авторы и участники этого проекта не несут ответственности за любые убытки, действия с аккаунтом или последствия, возникающие в результате использования этого программного обеспечения. Используйте на свой страх и риск.