godot-mcp-pro — Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

169 MCP-Tools in 23 Kategorien für eine umfassende Godot 4-Entwicklung
Real-time WebSocket connection with auto-reconnect and heartbeat monitoring
Vollständige UndoRedo-Integration – alle Knoten-/Eigenschaftsvorgänge sind umkehrbar
Smart type parsing for Vector2, Color, hex codes, and Godot-specific types
Three modes: Full (169 tools), Lite (80), Minimal (35) for different client limits

Live-Demo

In der Praxis

godot-mcp-pro-2.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "godot-mcp-pro-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/youichi-uda/godot-mcp-pro"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "godot-mcp-pro-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/youichi-uda/godot-mcp-pro"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "godot-mcp-pro-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/youichi-uda/godot-mcp-pro"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "godot-mcp-pro-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/youichi-uda/godot-mcp-pro"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "godot-mcp-pro-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/youichi-uda/godot-mcp-pro"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "godot-mcp-pro-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/youichi-uda/godot-mcp-pro"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add godot-mcp-pro-2 -- TODO 'See README: https://github.com/youichi-uda/godot-mcp-pro'

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: godot-mcp-pro

How to build a Godot scene with AI using Godot MCP Pro

👤 Godot-Entwickler, die eine KI-gestützte Szenenerstellung wünschen ⏱ ~20 min beginner

Wann einsetzen: Sie möchten schnell einen Prototyp einer Spielszene erstellen, indem Sie sie in natürlicher Sprache beschreiben.

Voraussetzungen

Godot 4 mit MCP Pro-Plugin — Kopieren Sie addons/godot_mcp/ in Ihr Projekt und aktivieren Sie es in den Projekteinstellungen → Plugins
Node.js MCP-Server — cd server && npm install && npm run build

Ablauf

Beschreiben Sie die Szene

Erstellen Sie ein 2D-Plattform-Level mit einem Spieler-CharacterBody2D, 5 Plattformen als StaticBody2D und einem Zielbereich. Richten Sie Kollisionsformen für alle ein.✓ Kopiert

→ Szenenbaum mit allen Knoten, Kollisionsformen und der richtigen Hierarchie erstellt
Skripte hinzufügen

Fügen Sie dem Player ein Bewegungsskript mit Schwerkraft, Sprung und horizontaler Bewegung hinzu. Verwenden Sie Input.is_action_pressed für Eingaben.✓ Kopiert

→ GDScript angehängt und funktionsfähig
Testen Sie das Niveau

Starten Sie einen Spieltest und sagen Sie mir, ob der Spieler das Ziel erreichen kann. Suchen Sie nach Kollisionsproblemen.✓ Kopiert

→ Spieltestergebnisse mit Beobachtungen

Ergebnis: Ein spielbarer Prototyp-Level, der vollständig in natürlicher Sprache erstellt wurde.

Fallstricke

Zu viele Tools überfordern einige MCP-Clients — Wechseln Sie in den Lite-Modus (80 Tools) oder den Minimal-Modus (35), wenn Ihr Kunde mit dem vollständigen Satz Probleme hat

Kombinieren mit: filesystem

Erstellen und iterieren Sie Animationen in Godot mit KI-Unterstützung

👤 Spieleentwickler arbeiten an Charakteranimationen und -effekten ⏱ ~15 min intermediate

Wann einsetzen: Sie möchten Animationen erstellen, optimieren oder debuggen, ohne Keyframes manuell zu bearbeiten.

Voraussetzungen

Godot MCP Pro verbunden — Plugin aktiviert und MCP-Server läuft

Ablauf

Erstellen Sie eine Animation

Erstellen Sie einen AnimationPlayer auf dem Player-Knoten mit einer „Walk“-Animation: Verschieben Sie das Sprite in einer Schleife über 0,4 Sekunden um 4 Pixel nach oben und unten.✓ Kopiert

→ Mit festgelegten Keyframes erstellte Animation
Vorschau und Anpassung

Spielen Sie die Gehanimation ab. Es sieht zu schnell aus – verlangsamen Sie es auf 0,6 Sekunden und fügen Sie eine Ease-in-out-Kurve hinzu.✓ Kopiert

→ Animation mit neuem Timing und neuer Lockerung aktualisiert

Ergebnis: Ausgefeilte Animationen, erstellt und verfeinert durch iteratives KI-Feedback.

Fallstricke

Komplexe AnimationTree-Setups sind in natürlicher Sprache schwer zu beschreiben — Erstellen Sie die AnimationTree-Struktur Schritt für Schritt, einen Blend-Knoten nach dem anderen

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

godot-mcp-pro-2 + filesystem

Generieren und speichern Sie GDScript-Dateien zusammen mit Szenenänderungen

Erstellen Sie ein feindliches KI-Skript mit Patrouillen- und Verfolgungszuständen, speichern Sie es unter res://scripts/enemy_ai.gd und hängen Sie es an den feindlichen Knoten an.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen
create_node	type: str, name: str, parent_path?: str	Fügen Sie dem Szenenbaum einen neuen Knoten hinzu
set_property	node_path: str, property: str, value: any	Legen Sie eine beliebige Eigenschaft auf einem Knoten fest (unterstützt UndoRedo).
attach_script	node_path: str, code: str	Hängen Sie ein GDScript an einen Knoten an
create_animation	player_path: str, name: str, keyframes: obj	Erstellen Sie eine Animation mit Keyframes
run_scene	scene_path?: str	Starten Sie einen Playtest der aktuellen oder angegebenen Szene
get_scene_tree	none	Rufen Sie die aktuelle Szenenbaumstruktur ab

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: N/A – vollständig lokale WebSocket-Verbindung
Tokens pro Aufruf: 100–500 Token pro Tool-Aufruf
Kosten in €: Einmaliger Kauf im Wert von 5 $ – inklusive lebenslanger Updates
Tipp: Verwenden Sie den Minimalmodus (35 Werkzeuge), wenn Sie nur grundlegende Szenen- und Skriptoperationen benötigen.

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: N/A – nur lokale WebSocket-Verbindung

Datenabfluss: Die gesamte Kommunikation erfolgt lokal zwischen MCP-Server und Godot-Editor (localhost WebSocket).

Fehlerbehebung

Häufige Fehler und Lösungen

WebSocket connection failed

Stellen Sie sicher, dass das Godot-Plugin aktiviert ist und der Node.js-Server ausgeführt wird. Überprüfen Sie, ob der Port in .mcp.json mit den Plugin-Einstellungen übereinstimmt.

Prüfen: Check Godot's output panel for MCP plugin messages

Tool count exceeds client limit

Wechseln Sie in der MCP-Konfiguration in den Lite-Modus (80 Tools) oder den Minimal-Modus (35 Tools).

Prüfen: Update the mode parameter in .mcp.json

Property not updating

Bei einigen Eigenschaften muss die Szene gespeichert und erneut geladen werden. Versuchen Sie, die Szene nach der Änderung zu speichern.

Prüfen: Check the Godot Inspector panel for the property value

Alternativen

godot-mcp-pro vs. andere

Alternative	Wann stattdessen	Kompromiss
Godot MCP (free community)	Sie möchten eine kostenlose Alternative mit weniger Funktionen	Weniger Werkzeuge, aber keine Kosten

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen