grok-bot-mcp

MCP-Server für Grok Bot – lassen Sie jeden KI-Agenten Ihre Bots steuern.

Erstellen Sie Bots, lesen Sie Transkripte, senden Sie Nachrichten, durchsuchen Sie den Verlauf und prüfen Sie die Nutzung – alles über das Model Context Protocol. Funktioniert mit Claude Desktop, Cursor, Windsurf, Cline, VS Code Copilot und jedem MCP-kompatiblen Client.

Begleitprojekt zu: gbu – Grok Bot Usage-Checker

Was das tut

grok-bot-mcp ist ein MCP-Server, der KI-Agenten (Claude, Cursor, Copilot usw.) mit Ihrer lokal laufenden Grok Bot-Instanz verbindet. Nach der Installation kann jeder MCP-kompatible KI-Client:

• Bots erstellen, auflisten, durchsuchen und löschen – ohne die Grok Bot-App zu öffnen

• Nachrichten an Bots senden und Antworten erhalten – direkt aus Ihrem KI-Editor

• Konversationstranskripte lesen – vollständiger Verlauf jedes Bots

• Alle Bot-Nachrichten durchsuchen – Volltextsuche in lokalen Datenbanken

• Nutzung und Abrechnung prüfen – wöchentliche Nutzung in %, On-Demand-Ausgaben, Reset-Zeiten

• Lokale Datenbanken auflisten – alle store.db-Dateien der Agenten und ihre Größen anzeigen

Alles über die standardisierte MCP-Tool-Schnittstelle. Keine benutzerdefinierte API-Integration erforderlich.

Related MCP server: Grok MCP

Installation

Ein Befehl (macOS / Linux):

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

Das Installationsskript erkennt automatisch, welche KI-Agenten Sie installiert haben, und konfiguriert den MCP-Server für jeden davon. Starten Sie Ihren KI-Agenten nach der Installation neu.

Was konfiguriert wird:

Tools

Der MCP-Server stellt jedem verbundenen KI-Agenten diese Tools zur Verfügung:

Agentenverwaltung

Nachrichten

Datenbank

Nutzung

So funktioniert es

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

Der Server findet das Grok Bot-Gateway, indem er gateway-descriptor.json entschlüsselt (gleiche macOS-Keychain-Technik wie gbu). Für Datenbankabfragen liest er die lokalen SQLite-Dateien direkt im Nur-Lese-Modus.

Manuelle Konfiguration

Wenn Sie die Konfiguration lieber manuell vornehmen möchten, fügen Sie dies zu Ihrer MCP-Konfigurationsdatei hinzu:

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

Voraussetzungen

• Node.js 18+

• Grok Bot-App installiert und ausgeführt (für Gateway- und Keychain-Zugriff)

• macOS (für Gateway-Erkennung und Keychain-Entschlüsselung; Datenbanklesevorgänge funktionieren auf jedem Betriebssystem, wenn die Dateien vorhanden sind)

Tests

Tests verwenden Mocks – keine echten Grok Bot-Aufrufe, kein Netzwerk, keine Datenbankschreibvorgänge:

node --test tests/*.test.mjs

Sicherheit

• Nur-Lese-Datenbankzugriff – PRAGMA query_only = 1 bei allen SQLite-Abfragen

• Keine Geheimnisse in MCP-Antworten – Tokens werden niemals an den KI-Agenten zurückgegeben

• Gateway-Token wird beim Start entschlüsselt – wird nie auf die Festplatte geschrieben

• Nur lokal – stdio-Transport, kein Netzwerk-Server verfügbar

• Keine Telemetrie – keine Aufrufe außer an 127.0.0.1 (Gateway) und api2.cursor.sh (Nutzung)

Deinstallation

rm -rf ~/.gbm

Entfernen Sie dann den grok-bot-Eintrag aus der MCP-Konfigurationsdatei Ihres KI-Agenten.

Begleitprojekt

gbu – Grok Bot Usage-Checker-CLI. Nutzungsprüfung für mehrere Konten vom Terminal aus. Gleiche Token-Verwaltung, gleiche API, andere Schnittstelle (CLI vs. MCP).

Lizenz

MIT

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

⭐ Vergib einen Stern, wenn dies Ihrem KI-Agenten ermöglicht, Ihre Bots zu steuern.

Haftungsausschluss

Dieses Projekt ist ein unabhängiges, pädagogisches Werkzeug, das zu Lern- und Forschungszwecken erstellt wurde. Es ist nicht mit Cursor, Anysphere, Grok, Grok Bot, SpaceXAI, xAI, SpaceX oder einem anderen Unternehmen, Produkt oder einer anderen Einrichtung verbunden, von diesen unterstützt, gesponsert oder mit diesen assoziiert.

Alle in diesem Repository erwähnten Produktnamen, Logos, Marken und eingetragenen Marken sind Eigentum ihrer jeweiligen Inhaber. Die Verwendung von Namen oder Logos dient nur der Identifikation und pädagogischen Referenz und impliziert keine Unterstützung, Partnerschaft oder Verbindung.

Dieses Tool interagiert mit lokal laufenden Anwendungen und öffentlich zugänglichen API-Endpunkten unter Verwendung von Anmeldedaten, die Sie bereits besitzen. Es umgeht keine Authentifizierung, sammelt keine geschützten Inhalte und greift nicht auf nicht-öffentliche Systeme zu. Sie sind allein dafür verantwortlich, die Nutzungsbedingungen jeder Plattform einzuhalten, die Sie mit diesem Tool verwenden.

Die Autoren und Mitwirkenden dieses Projekts übernehmen keine Haftung für Schäden, Kontomaßnahmen oder Folgen, die aus der Verwendung dieser Software entstehen. Nutzung auf eigenes Ermessen.