Grok-MCP

MCP-Server für die Grok-API von xAI mit agentischem Tool-Aufruf, Bild- und Videogenerierung, Vision-Funktionen und Dateisupport.

Funktionen

Agentischer Tool-Aufruf: Websuche, X-Suche und Codeausführung mit mehrstufigem Reasoning
Mehrere Grok-Modelle: Zugriff auf die neuesten Modelle wie grok-4.20-0309-reasoning, grok-4-1-fast-reasoning und mehr
Bild- und Videogenerierung: Erstellen Sie Bilder und Videos mit Grok Imagine
Vision-Fähigkeiten: Analysieren Sie Bilder mit den Vision-Modellen von Grok
Files API: Hochladen, Verwalten und Chatten mit Dokumenten
Zustandsbehaftete Konversationen: Behalten Sie den Konversationskontext als ID über mehrere Anfragen hinweg bei
Lokaler Chatverlauf: Option zum Speichern eines persistenten clientseitigen Chatverlaufs als JSON-Dateien in chats/

Related MCP server: Zen MCP Server

Voraussetzungen

Python 3.11 oder höher
xAI API-Schlüssel (Hier erhalten)
Astral UV

Installation

Klonen Sie das Repository:

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

Erstellen Sie eine venv-Umgebung:

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

Installieren Sie die Abhängigkeiten:

uv sync

Konfiguration

Claude Desktop-Integration

Fügen Sie dies Ihrer Claude Desktop-Konfigurationsdatei hinzu:

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

Claude Code-Integration

Führen Sie diesen Befehl innerhalb des Projektverzeichnisses aus:

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

Oder falls Sie eine .env-Datei mit Ihrem Schlüssel haben:

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

Überprüfen Sie, ob es registriert ist:

claude mcp list

Filesystem MCP (Optional)

Claude Desktop kann hochgeladene Bilder im Chat nicht an ein MCP-Tool senden. Der einfachste Weg, um direkt von Ihrem Computer aus auf Dateien zuzugreifen, ist der offizielle Filesystem MCP-Server. Nachdem Sie ihn eingerichtet haben, können Sie einfach den Dateipfad des Bildes (z. B. /Users/mert/Desktop/image.png) in den Chat schreiben und Claude kann ihn mit jedem Vision-Chat-Tool verwenden.

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

Für stdio:

uv run python main.py

Docker:

docker compose up --build

Mcp Inspector:

mcp dev main.py

Verfügbare Tools

Jedes Tool verfügt über einen vollständigen Docstring in src/server.py mit seinen Argumenten und dem Rückgabeformat. Der MCP-Client zeigt diese direkt an, daher ist diese Liste nur eine kurze Übersicht dessen, was verfügbar ist.

Hinweis: Um Bilder und Dateien zu verwenden, müssen Sie Pfade zum Chat bereitstellen. Siehe Filesystem MCP (Optional) für die Einrichtung.

Chat und Reasoning

chat — Standard-Chat-Vervollständigung mit optionalem persistentem Verlauf und Multi-Agenten-Unterstützung.
chat_with_vision — Analysieren Sie lokale oder entfernte Bilder mit einem Grok-Vision-Modell.
chat_with_files — Chatten basierend auf zuvor hochgeladenen Dokumenten.
stateful_chat — Setzen Sie eine serverseitig gespeicherte Konversation über response_id fort.
retrieve_stateful_response — Rufen Sie eine gespeicherte Antwort per ID ab.
delete_stateful_response — Löschen Sie eine gespeicherte Antwort per ID.

Agentische Tools

web_search — Autonome Web-Recherche mit Domain-Filtern und Zitaten.
x_search — Autonome Suche über X (Twitter)-Posts mit Handle- und Datumsfiltern.
code_executor — Lösen Sie Aufgaben durch Ausführen von Python in einer Sandbox.
grok_agent — Einheitlicher Agent, der Dateien, Bilder, Websuche, X-Suche und Codeausführung kombiniert.

Bild und Video

generate_image — Erstellen oder bearbeiten Sie Bilder mit Grok Imagine (Bearbeitung mit mehreren Referenzen unterstützt).
generate_video — Text-zu-Video, Bild-zu-Video oder Videobearbeitung mit Grok Imagine.
extend_video — Erweitern Sie ein bereits generiertes Video mit einem Folge-Prompt.

Dateien

upload_file — Laden Sie ein lokales Dokument hoch.
list_files — Listen Sie hochgeladene Dateien mit Sortierung auf.
get_file — Rufen Sie Dateimetadaten per ID ab.
get_file_content — Laden Sie Dateiinhalte als Text herunter.
delete_file — Löschen Sie eine Datei per ID.

Lokaler Chatverlauf

list_chat_sessions — Listen Sie gespeicherte Sitzungen in chats/ auf.
get_chat_history — Rufen Sie das vollständige Transkript einer Sitzung ab.
clear_chat_history — Löschen Sie die lokale Verlaufsdatei einer Sitzung.

Modelle

list_models — Listen Sie alle Grok-Sprach- und Bildmodelle mit Live-Preisen auf.

Lizenz

Dieses Projekt ist Open Source und unter der MIT-Lizenz verfügbar.

Grok MCP