Godot MCP

Fork von Coding-Solo/godot-mcp bei Commit 1209744 (MIT). Dieser Fork wird unabhängig von @jamesdowzard gepflegt und fügt Unterstützung für den Android-Export-Validator sowie weitere KI-freundliche Werkzeuge hinzu. Die Upstream-Fork-Beziehung ist auf Git-Ebene getrennt; Urheberrecht/Namensnennung gemäß MIT bleiben erhalten.

                           (((((((             (((((((
                        (((((((((((           (((((((((((
                        (((((((((((((       (((((((((((((
                        (((((((((((((((((((((((((((((((((
                        (((((((((((((((((((((((((((((((((
         (((((      (((((((((((((((((((((((((((((((((((((((((      (((((
       (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
     ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
    ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
      (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
        (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         (((((((((((@@@@@@@(((((((((((((((((((((((((((@@@@@@@(((((((((((
         (((((((((@@@@,,,,,@@@(((((((((((((((((((((@@@,,,,,@@@@(((((((((
         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((
         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((
         (((((((((@@@,,,,,,,@@((((((((@@@@@((((((((@@,,,,,,,@@@(((((((((
         ((((((((((((@@@@@@(((((((((((@@@@@(((((((((((@@@@@@((((((((((((
         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
         @@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@
         ((((((((( @@@(((((((((((@@(((((((((((@@(((((((((((@@@ (((((((((
         (((((((((( @@((((((((((@@@(((((((((((@@@((((((((((@@ ((((((((((
          (((((((((((@@@@@@@@@@@@@@(((((((((((@@@@@@@@@@@@@@(((((((((((
           (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((
              (((((((((((((((((((((((((((((((((((((((((((((((((((((
                 (((((((((((((((((((((((((((((((((((((((((((((((
                        (((((((((((((((((((((((((((((((((


                          /$$      /$$  /$$$$$$  /$$$$$$$
                         | $$$    /$$$ /$$__  $$| $$__  $$
                         | $$$$  /$$$$| $$  \__/| $$  \ $$
                         | $$ $$/$$ $$| $$      | $$$$$$$/
                         | $$  $$$| $$| $$      | $$____/
                         | $$\  $ | $$| $$    $$| $$
                         | $$ \/  | $$|  $$$$$$/| $$
                         |__/     |__/ \______/ |__/

Ein Model Context Protocol (MCP)-Server für die Interaktion mit der Godot-Game-Engine.

Einführung

Godot MCP ermöglicht es KI-Agenten, den Godot-Editor zu starten, Projekte auszuführen, Debug-Ausgaben zu erfassen und die Projektausführung zu steuern. Diese direkte Feedbackschleife hilft Agenten zu verstehen, was in echten Godot-Projekten funktioniert und was nicht, was zu einer besseren Codegenerierung und Debugging-Unterstützung führt.

Funktionen

• Godot-Editor starten: Öffnen Sie den Godot-Editor für ein bestimmtes Projekt

• Godot-Projekte ausführen: Führen Sie Godot-Projekte im Debug-Modus aus

• Debug-Ausgabe erfassen: Konsolenausgaben und Fehlermeldungen abrufen

• Ausführung steuern: Godot-Projekte programmgesteuert starten und stoppen

• Godot-Version abrufen: Die installierte Godot-Version abrufen

• Godot-Projekte auflisten: Godot-Projekte in einem angegebenen Verzeichnis finden

• Projektanalyse: Detaillierte Informationen über die Projektstruktur erhalten

• Szenenverwaltung:

  • Neue Szenen mit angegebenen Root-Knotentypen erstellen

  • Knoten zu bestehenden Szenen mit anpassbaren Eigenschaften hinzufügen

  • Sprites und Texturen in Sprite2D-Knoten laden

  • 3D-Szenen als MeshLibrary-Ressourcen für GridMap exportieren

  • Szenen mit Optionen zum Erstellen von Varianten speichern

• UID-Verwaltung (für Godot 4.4+):

  • UID für bestimmte Dateien abrufen

  • UID-Referenzen durch erneutes Speichern von Ressourcen aktualisieren

Anforderungen

• Godot Engine auf Ihrem System installiert

• Node.js (>=18.0.0) und npm

• Ein KI-Agent, der MCP unterstützt

Schnellstart

Claude Code

claude mcp add godot -- npx @coding-solo/godot-mcp

Das ist alles. Starten Sie Claude Code neu und Ihre Godot MCP-Tools sind verfügbar.

Mit Umgebungsvariablen:

claude mcp add godot -e GODOT_PATH=/path/to/godot -e DEBUG=true -- npx @coding-solo/godot-mcp

Fügen Sie dies zu Ihrer Cline MCP-Konfigurationsdatei hinzu (~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json):

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "DEBUG": "true"
      },
      "disabled": false,
      "autoApprove": [
        "launch_editor",
        "run_project",
        "get_debug_output",
        "stop_project",
        "get_godot_version",
        "list_projects",
        "get_project_info",
        "create_scene",
        "add_node",
        "load_sprite",
        "export_mesh_library",
        "save_scene",
        "get_uid",
        "update_project_uids"
      ]
    }
  }
}

Verwendung der Cursor-Benutzeroberfläche:

1. Gehen Sie zu Cursor Settings > Features > MCP

2. Klicken Sie auf die Schaltfläche + Add New MCP Server

3. Füllen Sie das Formular aus:

   • Name: godot

   • Type: command

   • Command: npx @coding-solo/godot-mcp

4. Klicken Sie auf "Add"

5. Möglicherweise müssen Sie die Aktualisierungsschaltfläche in der oberen rechten Ecke der MCP-Server-Karte drücken, um die Tool-Liste zu laden

Verwendung der projektspezifischen Konfiguration:

Erstellen Sie eine Datei unter .cursor/mcp.json in Ihrem Projektverzeichnis:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "DEBUG": "true"
      }
    }
  }
}

Für jeden MCP-kompatiblen Client verwenden Sie diese Konfiguration:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["@coding-solo/godot-mcp"],
      "env": {
        "GODOT_PATH": "/path/to/godot",
        "DEBUG": "true"
      }
    }
  }
}

Umgebungsvariablen

git clone https://github.com/Coding-Solo/godot-mcp.git
cd godot-mcp
npm install
npm run build

Verweisen Sie dann Ihren MCP-Client auf build/index.js, anstatt npx zu verwenden.

Architektur

Der Godot MCP-Server verwendet einen gebündelten GDScript-Ansatz für komplexe Operationen:

1. Direkte Befehle: Einfache Operationen wie das Starten des Editors oder das Abrufen von Projektinformationen verwenden direkt die integrierten CLI-Befehle von Godot.

2. Gebündeltes Operationsskript: Komplexe Operationen wie das Erstellen von Szenen oder das Hinzufügen von Knoten verwenden eine einzige, umfassende GDScript-Datei (godot_operations.gd), die alle Operationen abwickelt.

Das gebündelte Skript akzeptiert den Operationstyp und die Parameter als JSON, was eine flexible und dynamische Ausführung von Operationen ermöglicht, ohne für jede Operation temporäre Dateien zu generieren.

Fehlerbehebung

• Godot nicht gefunden: Setzen Sie die Umgebungsvariable GODOT_PATH auf den Pfad Ihrer ausführbaren Godot-Datei

• Verbindungsprobleme: Stellen Sie sicher, dass der Server läuft, und starten Sie Ihren KI-Assistenten neu

• Ungültiger Projektpfad: Stellen Sie sicher, dass der Pfad auf ein Verzeichnis zeigt, das eine project.godot-Datei enthält

• Build-Probleme: Stellen Sie sicher, dass alle Abhängigkeiten durch Ausführen von npm install installiert wurden

• Stellen Sie sicher, dass der MCP-Server in den Cursor-Einstellungen angezeigt und aktiviert ist (Settings > MCP)

• MCP-Tools können nur mit dem Agent-Chat-Profil ausgeführt werden (Cursor Pro- oder Business-Abonnement)

• Verwenden Sie den "Yolo Mode", um MCP-Tool-Anfragen automatisch auszuführen

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert - siehe die Datei LICENSE für Details.