Godot MCP

Verschaffe deinem KI-Assistenten vollen Zugriff auf den Godot-Editor.

Entwickle Spiele schneller mit Claude, Cursor oder jeder MCP-kompatiblen KI – kein Kopieren und Einfügen, kein Kontextwechsel. Die KI liest, schreibt und manipuliert deine Szenen, Skripte, Nodes und Projekteinstellungen direkt.

Godot 4.x · 42 Werkzeuge · Interaktiver Projekt-Visualizer · MIT-Lizenz

Schnellstart

0. Node.js installieren (einmalige Einrichtung)

Lade das Installationsprogramm von nodejs.org herunter und führe es aus (LTS-Version). Es ist ein Standard-Installer – kein Terminal erforderlich.

1. Das Godot-Plugin installieren

Klicke im Godot-Editor oben auf den Tab AssetLib → suche nach „mcp“ → finde „Godot AI Assistant tools MCP“ → Installieren.

Gehe dann zu Projekt → Projekteinstellungen → Plugins und aktiviere das Godot MCP-Plugin.

2. Füge die Server-Konfiguration zu deinem KI-Client hinzu

Claude Desktop — Einstellungen → Entwickler → Konfiguration bearbeiten → öffne die Konfigurationsdatei und füge ein:

Mac / Linux:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-server"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "godot": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "godot-mcp-server"]
    }
  }
}

Cursor — Einstellungen → MCP → Server hinzufügen:

Mac / Linux:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-server"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "godot": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "godot-mcp-server"]
    }
  }
}

Claude Code — im Terminal ausführen:

claude mcp add godot -- npx -y godot-mcp-server

Funktioniert mit jedem MCP-kompatiblen Client (Cline, Windsurf, etc.)

3. Starte deinen KI-Client neu

Schließe und öffne Claude Desktop / Cursor / deinen Client erneut, damit die neue Konfiguration übernommen wird.

4. Starte dein Godot-Projekt neu

Klicke im Godot-Editor auf Projekt neu starten. Überprüfe die obere rechte Ecke – du solltest MCP Connected in Grün sehen. Du bist startklar.

Related MCP server: Godot MCP Bridge

Was kann es?

42 Werkzeuge in 6 Kategorien

Interaktiver Visualizer

Führe map_project aus und erhalte einen browserbasierten Explorer auf localhost:6510:

• Kraftgerichteter Graph aller Skripte und ihrer Beziehungen

• Klicke auf ein beliebiges Skript, um Variablen, Funktionen, Signale und Verbindungen zu sehen

• Bearbeite Code direkt im Visualizer – Änderungen werden in Echtzeit mit Godot synchronisiert

• Szenenansicht mit Bearbeitung von Node-Eigenschaften

• Finde Verwendungen vor dem Refactoring

Einschränkungen

Eine KI kann nicht 100% eines Spiels allein erstellen – sie tut sich schwer mit komplexen UI-Layouts, dem Compositing von Szenen und der Manipulation einiger Node-Eigenschaften. Sie befindet sich noch in aktiver Entwicklung, daher ist Feedback sehr willkommen!

Architektur

┌─────────────┐    MCP (stdio)   ┌──────────────┐   WebSocket   ┌──────────────┐
│  AI Client  │◄────────────────►│  MCP Server  │◄─────────────►│ Godot Editor │
│  (Claude,   │                  │  (Node.js)   │   port 6505   │  (Plugin)    │
│   Cursor)   │                  │              │               │              │
└─────────────┘                  │  Visualizer  │               │  42 tool     │
                                 │  HTTP :6510  │               │  handlers    │
                                 └──────┬───────┘               └──────────────┘
                                        │
                                 ┌──────▼───────┐
                                 │   Browser    │
                                 │  Visualizer  │
                                 └──────────────┘

Aktuelle Einschränkungen

• Nur lokal — läuft auf localhost, keine Remote-Verbindungen

• Einzelverbindung — jeweils eine Godot-Instanz

• Kein Rückgängig — Änderungen werden direkt gespeichert (Versionierung verwenden)

• KI-Wissen über Godot ist noch begrenzt — sie kann nicht 100% des Spiels allein erstellen, kann aber beim Debuggen helfen, Skripte schreiben und dich auf der Reise begleiten

Entwicklung

Um aus dem Quellcode zu bauen, anstatt npm zu verwenden:

cd mcp-server
npm install
npm run build

Richte deinen KI-Client dann auf mcp-server/dist/index.js aus, anstatt npx zu verwenden.

Versionshinweise

Ausführliche Beschreibungen zu jeder Version findest du in release-notes/ (beginnend mit v0.5.0). Den vollständigen Änderungsverlauf findest du in CHANGELOG.md.

Lizenz

MIT

npm-Paket · Probleme melden