Ein MCP-Server zur Interaktion mit der Godot-Spielengine. Bietet Werkzeuge zum Starten des Editors, Ausführen von Projekten und Erfassen von Debug-Ausgaben.

📚 Godot MCP Projektvorstellung

I. Projektübersicht

Godot MCP (Model Context Protocol Server) wurde von Coding‑Solo veröffentlicht und ist ein Tool, das KI-Assistenten mit der Godot Engine verbindet. Über das MCP-Protokoll kann es den Godot-Editor starten, Projekte ausführen, Debugging-Informationen erfassen und Projekte und Szenen umfassend steuern.

Dieser Mechanismus bietet KI-Assistenten (wie Claude, Cline, Cursor) eine echte Feedbackschleife, die es ihnen ermöglicht, Projekte tatsächlich zu bedienen, Probleme zu debuggen und hochwertigen GDScript-Code zu generieren.

---

II. Kernfunktionen und -merkmale

1. Editor starten und Projekte ausführen Unterstützt über die Befehlszeile:

   • Starten des Godot-Editors unter einem bestimmten Pfad
   • Ausführen von Projekten im Debug-Modus
   • Erfassen und Zurückgeben von Konsolenausgaben oder Fehlermeldungen

2. Projektstruktur erfassen und analysieren

   • Abrufen von Projektversion, Verzeichnisstruktur und Ressourcenliste
   • Detaillierte Informationen zur Szenenstruktur, einschließlich Knotenbaum, Attribute, Ressourcenpfade usw.

3. Szenen- und Knotenverwaltung

   • Erstellen neuer Szenen (Angabe des Root-Knotentyps)
   • Hinzufügen von Knoten zu bestehenden Szenen und Festlegen von Attributen
   • Laden von Sprite2D-Texturen, Exportieren von MeshLibrary für GridMap
   • Speichern von Szenen und Unterstützung der Generierung von Szenenvarianten

4. Debugging und Versionsverwaltung

   • Stoppen eines laufenden Projekts
   • Abrufen und Anzeigen der Godot Engine-Version
   • (Gilt für Godot 4.4+) Abrufen der Datei-UID und Aktualisieren von Ressourcenreferenzen

5. Kompatibel mit verschiedenen KI-gestützten Tools

   • Unterstützt Cline und Cursor: Integration von KI-Assistenten-Tools über MCP-Einstellungsdateien und Befehlszeile

---

III. Architektur und Implementierungshighlights

• Ein einzelnes GDScript "Operationsskript" Alle komplexen Befehle (wie Knotenerstellung, Szenenexport usw.) werden von einem godot_operations.gd verwaltet, wodurch die Generierung einzelner temporärer Skripte vermieden wird, was für Einfachheit und Effizienz sorgt und die Wahrscheinlichkeit von Festplatten-I/O und Fehlern reduziert.

• CLI- und Skript-Kombinationsmechanismus Einfache Befehle direkt über die Godot CLI, komplexe Operationen über GDScript-Skripte, alle über MCP-Standard-JSON-Anweisungen übertragen, einheitliche Struktur, leicht erweiterbar.

• Standardisierte Antwortstruktur Alle Operationen geben ein einheitliches Format zurück: Status, Ergebnisinhalt, Standardausgabe/Fehler, um die Analyse, das Lernen und die automatische Generierung von Änderungsvorschlägen durch die KI zu erleichtern.

---

IV. Verwendungsprozess

1. Installation und Build

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

2. Konfiguration von KI-Tools

   • Cline: Fügen Sie die entsprechende Serverkonfiguration in cline_mcp_settings.json hinzu
   • Cursor: Fügen Sie den Node-Befehl über Settings → Features → MCP hinzu

3. Ausführung und Interaktion

   • KI-Befehlsbeispiele:

     • launch_editor: Startet den Editor
     • run_project: Führt das Projekt aus und ruft die Ausgabe ab
     • create_scene / add_node: Erstellt Szenen/Knoten
     • get_debug_output / stop_project: Debugging-Steuerungsbefehle
     • get_uid / update_project_uids: UID-Verwaltung

---

V. Projekt-Highlights Zusammenfassung

Vorteil	Beschreibung
🌟 Hohe Automatisierung	KI-Assistenten steuern den Editor/das Projekt direkt, ohne manuellen Eingriff
🚫 Keine temporären Dateien	Verwendung eines einzelnen GDScript-Einstiegspunkts, leicht und effizient
♻️ Unterstützung für Version & UID	Kompatibel mit Godot 4.4+ Funktionen, kann Ressourcen-UIDs verwalten
🛠️ Leicht erweiterbar & integrierbar	MCP-Standard erleichtert das Hinzufügen neuer Funktionen, kompatibel mit mehreren KI-Tools

---

VI. Zusammenfassung 🌈

Godot MCP ist ein leistungsstarkes und praktisches Tool, das eine Brücke zwischen KI-Assistenten und der Godot Engine schlägt. Die KI kann direkt:

• Editor starten, Projekte ausführen, Daten erfassen;
• Auf Projektstruktur, Skripte, Szenen, Ressourcen zugreifen;
• Szenen, Knoten, Skripte dynamisch ändern;
• Debuggen und GDScript-Codevorschläge generieren.

Mithilfe eines einheitlichen Protokolls und GDScript-Operationsskripts bietet es eine klare, standardisierte und erweiterbare Automatisierungsschnittstelle, die für Spieleentwickler ein Werkzeug zur Steigerung der Effizienz und zur intelligenten Entwicklung ist.