grok-bot-mcp

Servidor MCP para Grok Bot: permite que cualquier agente de IA controle tus bots.

Crea bots, lee transcripciones, envía mensajes, busca en el historial y consulta el uso, todo a través del Model Context Protocol. Funciona con Claude Desktop, Cursor, Windsurf, Cline, VS Code Copilot y cualquier cliente compatible con MCP.

Complemento de: gbu — Grok Bot Usage checker

Qué hace esto

grok-bot-mcp es un servidor MCP que conecta agentes de IA (Claude, Cursor, Copilot, etc.) con tu instancia local de Grok Bot. Una vez instalado, cualquier cliente de IA compatible con MCP puede:

• Crear, listar, buscar y eliminar bots — sin abrir la aplicación Grok Bot

• Enviar mensajes a los bots y obtener respuestas — directamente desde tu editor de IA

• Leer transcripciones de conversaciones — historial completo de cualquier bot

• Buscar en todos los mensajes de los bots — búsqueda de texto completo en las bases de datos locales

• Consultar uso y facturación — porcentaje de uso semanal, gasto bajo demanda, tiempos de reinicio

• Listar bases de datos locales — ver todos los archivos store.db de los agentes y sus tamaños

Todo a través de la interfaz estandarizada de herramientas MCP. No se necesita integración de API personalizada.

Related MCP server: Grok MCP

Instalación

Un solo comando (macOS / Linux):

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

El script de instalación detecta automáticamente qué agentes de IA tienes instalados y configura el servidor MCP para cada uno. Reinicia tu agente de IA después de la instalación.

Lo que configura:

Herramientas

El servidor MCP expone estas herramientas a cualquier agente de IA conectado:

Gestión de agentes

Mensajería

Base de datos

Uso

Cómo funciona

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

El servidor descubre la puerta de enlace de Grok Bot descifrando gateway-descriptor.json (la misma técnica de macOS Keychain que gbu). Para las consultas a la base de datos, lee los archivos SQLite locales directamente en modo de solo lectura.

Configuración manual

Si prefieres configurarlo manualmente, añade esto a tu archivo de configuración MCP:

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

Requisitos

• Node.js 18+

• Aplicación Grok Bot instalada y en ejecución (para acceso a la puerta de enlace y al llavero)

• macOS (para el descubrimiento de la puerta de enlace y el descifrado del llavero; la lectura de la base de datos funciona en cualquier sistema operativo si los archivos existen)

Pruebas

Las pruebas usan mocks: sin llamadas reales a Grok Bot, sin red, sin escrituras en la base de datos:

node --test tests/*.test.mjs

Seguridad

• Acceso de solo lectura a la base de datos — PRAGMA query_only = 1 en todas las consultas SQLite

• Sin secretos en las respuestas MCP — los tokens nunca se devuelven al agente de IA

• Token de la puerta de enlace descifrado al inicio — nunca se escribe en el disco

• Solo local — transporte stdio, sin servidor de red expuesto

• Sin telemetría — cero llamadas excepto a 127.0.0.1 (puerta de enlace) y api2.cursor.sh (uso)

Desinstalación

rm -rf ~/.gbm

Luego elimina la entrada grok-bot del archivo de configuración MCP de tu agente de IA.

Proyecto complementario

gbu — CLI de verificación de uso de Grok Bot. Consulta de uso multi-cuenta desde la terminal. La misma gestión de tokens, la misma API, diferente interfaz (CLI vs MCP).

Licencia

MIT

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

⭐ Deja una estrella si esto permite que tu agente de IA controle tus bots.

Aviso legal

Este proyecto es una herramienta independiente y educativa creada con fines de aprendizaje e investigación. No está afiliado, respaldado, patrocinado ni asociado con Cursor, Anysphere, Grok, Grok Bot, SpaceXAI, xAI, SpaceX ni con ninguna otra empresa, producto o entidad.

Todos los nombres de productos, logotipos, marcas comerciales y marcas registradas mencionados en este repositorio son propiedad de sus respectivos dueños. El uso de cualquier nombre o logotipo es solo para identificación y referencia educativa, y no implica respaldo, asociación ni afiliación.

Esta herramienta interactúa con aplicaciones que se ejecutan localmente y con endpoints de API de acceso público utilizando credenciales que ya posees. No elude la autenticación, no extrae contenido protegido ni accede a ningún sistema no público. Eres el único responsable del cumplimiento de los Términos de Servicio de cualquier plataforma que uses con esta herramienta.

Los autores y colaboradores de este proyecto no asumen ninguna responsabilidad por daños, acciones en la cuenta o consecuencias derivadas del uso de este software. Úsalo bajo tu propio criterio.