Tutorials

Godot mit Antigravity über MCP verbinden: Schritt-für-Schritt-Anleitung

Melden

Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Systemen und externen Tools ermöglicht, nahtlos mit Entwicklungsumgebungen zu interagieren. In diesem Tutorial erfährst du, wie du deine Antigravity-Umgebung über MCP direkt an die Godot Engine anbindest, um Szenen zu manipulieren, Skripte zu analysieren und deine Game-Development-Workflows durch intelligente Agenten zu automatisieren.

Voraussetzungen

Bevor du beginnst, stelle sicher, dass folgende Software auf deinem System eingerichtet ist:

  • Godot Engine (Standard- oder .NET-Version)
  • Antigravity (Client-/Agenten-Umgebung mit MCP-Unterstützung)
  • Node.js oder Python (je nachdem, welche MCP-Server-Implementierung genutzt wird)
  • Ein bestehendes oder neues Godot-Projekt

Die Architektur im Überblick

Die Verbindung funktioniert über drei Stationen:

  1. Antigravity (MCP-Client): Sendet Prompts, Befehle und Werkzeugaufrufe.
  2. MCP-Server (Bridge): Übersetzt die MCP-Anfragen in Befehle, die Godot versteht (meist via WebSockets oder lokaler CLI).
  3. Godot (Engine/Editor): Führt die Aktionen im Projekt aus und meldet Status und Szenendaten zurück.

Schritt 1: Godot-Projekt vorbereiten

Damit externe Tools wie Antigravity über MCP Befehle an den Godot-Editor senden können, benötigt Godot eine Schnittstelle (meist ein Editor-Plugin oder eine WebSocket-Brücke).

  1. Öffne dein Godot-Projekt.
  2. Lege im Projektordner das Verzeichnis addons/mcp_bridge/ an.
  3. Falls du ein fertiges Godot-MCP-Plugin verwendest, kopiere die Dateien dort hinein.
  4. Aktiviere das Plugin im Editor:
    • Gehe auf Projekt -> Projekteinstellungen -> Plugins.
    • Setze den Haken bei Aktivieren neben deiner MCP-Bridge.
  5. Das Plugin startet nun im Hintergrund einen lokalen Port (standardmäßig oft ws://localhost:6008 oder über IPC), um auf Anweisungen zu lauschen.

Schritt 2: MCP-Server bereitstellen

Der MCP-Server fungiert als Übersetzer zwischen Antigravity und Godot.

  1. Lade den passenden Godot-MCP-Server herunter (meist ein Node- oder Python-Paket).
  2. Installiere die Abhängigkeiten über dein Terminal:
    cd /pfad/zu/godot-mcp-server
npm install
# oder bei Python-Servern:
pip install -r requirements.txt
  3. Teste, ob der Server lokal ausgeführt werden kann:
    node index.js

Schritt 3: Antigravity für MCP konfigurieren

Jetzt muss Antigravity beigebracht werden, wie es den Godot-MCP-Server aufruft. Dies geschieht über die Konfigurationsdatei von Antigravity (typischerweise eine antigravity_config.json oder mcp_settings.json).

  1. Öffne die Konfiguration von Antigravity.
  2. Füge den Godot-Server im Bereich mcpServers hinzu:
{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": [
        "/absoluter/pfad/zu/godot-mcp-server/index.js"
      ],
      "env": {
        "GODOT_PROJECT_PATH": "/absoluter/pfad/zu/deinem/GodotProjekt"
      }
    }
  }
}

Hinweis: Achte darauf, absolute Pfade zu verwenden, damit Antigravity die Skripte und das Projekt unabhängig vom aktuellen Arbeitsverzeichnis findet.

Schritt 4: Verbindung testen

  1. Starte deine Godot Engine und lade dein Projekt.
  2. Starte Antigravity.
  3. Antigravity sollte nun die bereitgestellten MCP-Tools für Godot automatisch erkennen (z. B. create_node, inspect_scene, get_node_tree, attach_script).
  4. Gib in Antigravity einen Test-Prompt ein:

    "Lies den aktuellen Szenenbaum meines Godot-Projekts aus und liste alle Nodes auf."

Wenn alles korrekt eingerichtet ist:

  • Fragt Antigravity den MCP-Server nach dem Szenenbaum.
  • Der MCP-Server holt sich die Daten aus dem laufenden Godot-Projekt.
  • Antigravity gibt dir die Struktur deiner Szene direkt im Chat/Interface aus.

Schritt 5: Typische Anwendungsfälle

Sobald die Verbindung steht, kannst du Workflows ausführen wie:

  • Szenenerstellung per Prompt: "Füge der aktuellen Hauptszene einen CharacterBody2D mit einem Sprite2D und einer CollisionShape2D hinzu."
  • GDScript-Analyse & Refactoring: "Prüfe das Skript 'Player.gd' auf Performance-Engpässe und aktualisiere es direkt über den MCP-Server."
  • Automatisierte Fehlerbehebung: Antigravity kann den Godot-Debug-Log auslesen und Korrekturen eigenständig im Code vornehmen.

Fehlerbehebung (Troubleshooting)

  • MCP-Server startet nicht: Prüfe, ob die Node.js- bzw. Python-Pfade im System-PATH hinterlegt sind und der absolute Pfad in der Antigravity-Config stimmt.
  • Keine Verbindung zu Godot: Stelle sicher, dass Godot geöffnet ist und das Bridge-Plugin aktiv lauscht. Überprüfe eventuelle Firewall-Blockaden auf dem gewählten Localhost-Port.
  • Rechteprobleme: Stelle sicher, dass der MCP-Server Lese- und Schreibrechte im Zielordner des Godot-Projekts besitzt.
0