Godot MCP Gateway

English | 简体中文

Ein Godot-Editor, mehrere KI-Coding-Agenten.

Godot MCP Gateway ist eine lokale Steuerungsebene, die Codex, Claude Code, OpenCode, Pi und anderen MCP-Clients ermöglicht, sich einen einzigen Godot-Editor sicher zu teilen. Jeder Client behält eine unabhängige MCP-Sitzung, während ein maschinenweites Gateway die Editor-Erkennung, Anfrage-Routing, Schreibplanung, Playtest-Zugriff, die Godot-LSP-Verbindung und Wiederverbindungen verwaltet.

Projektstatus: frühe Entwicklung. Die v1-Gateway-Topologie, heterogene Batch-Ausführung und die Editor-Aktivitäts-UI sind implementiert, aber das Projekt hat noch keine stabile Version veröffentlicht.

Warum ein Gateway?

Die meisten Godot-MCP-Integrationen starten einen Server und beanspruchen einen Editor-Port für jeden KI-Client. Dieses Modell wird fragil, wenn mehrere Agenten am selben Projekt arbeiten. Dieses Projekt trennt Agenten-Sitzungen von der Editor-Verbindung:

Codex -------- stdio shim --\
Claude Code -- stdio shim ---+-- local IPC -- Gateway -- WebSocket -- Godot Editor
OpenCode ----- stdio shim ---/                   |-- Playtest Runtime
Pi ----------- stdio shim --/                    `-- Godot LSP

Das Godot-Plugin verbindet sich ausgehend mit dem Gateway. Agenten beanspruchen niemals Godot-Portpools oder verbinden sich direkt mit dem Editor.

Related MCP server: agent-bus-mcp

Highlights

• Multi-Agenten-Sitzungen: Jeder MCP-Client hat eine eigene Identität, einen eigenen Lebenszyklus und einen eigenen Aktivitätsstream.

• Eine Editor-Verbindung: Das Gateway besitzt das Routing für Editor, Laufzeit und LSP.

• Geordnete Schreibvorgänge: Editor-Mutationen von verschiedenen Agenten werden FIFO geplant.

• Toolübergreifende Batches: batch führt heterogene MCP-Tools sequenziell aus, stoppt bei Fehlern und verhindert, dass sich Schreibvorgänge anderer Agenten dazwischenschieben.

• Sichtbare Operationen: Das Godot-Dock zeigt verbundene Agenten, wartende und laufende Arbeiten, Batch-Fortschritt und letzte Ergebnisse.

• Editor-Fokus: Erfolgreiche Mutationen können den betroffenen Knoten auswählen und fokussieren.

• Vollständige Tool-Basis: Der Upstream-Godot-Werkzeugkatalog bleibt über die Gateway-Architektur verfügbar.

Anforderungen

• Godot 4.2 oder neuer

• Node.js 22 oder neuer

• npm

Aus dem Quellcode ausführen

Repository klonen und bauen:

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

Kopieren Sie addons/godot_mcp_gateway/ in das addons/-Verzeichnis Ihres Godot-Projekts und aktivieren Sie dann Godot MCP Gateway unter Projekteinstellungen → Plugins.

Starten Sie das maschinenweite Gateway in einem Terminal und lassen Sie es laufen:

npm run start:gateway

Konfigurieren Sie jeden MCP-Client so, dass er seinen eigenen stdio-Shim startet. Ersetzen Sie /absolute/path/to/godot-mcp-gateway durch den absoluten Pfad des Klons:

{
  "mcpServers": {
    "godot-mcp-gateway": {
      "command": "node",
      "args": [
        "/absolute/path/to/godot-mcp-gateway/packages/server/dist/index.js",
        "stdio"
      ],
      "env": {
        "GODOT_MCP_PROJECT_PATH": "/absolute/path/to/your-godot-project"
      }
    }
  }
}

Wenn der MCP-Client im Godot-Projektstammverzeichnis startet, kann GODOT_MCP_PROJECT_PATH weggelassen werden. Setzen Sie GODOT_MCP_AGENT_NAME, um die im Dock angezeigte Agenten-Beschriftung zu überschreiben.

Batch-Beispiel

Das batch-Tool akzeptiert gewöhnliche Tool-Aufrufe:

{
  "calls": [
    {
      "tool": "scene_get_tree",
      "arguments": { "max_depth": 1 }
    },
    {
      "tool": "project_get_settings",
      "arguments": { "prefix": "application/" }
    }
  ]
}

Aufrufe werden der Reihe nach über die normale Validierungs- und Tool-Pipeline ausgeführt. Die Ausführung stoppt beim ersten fehlgeschlagenen oder abgebrochenen Schritt, und die übrigen Schritte werden als skipped markiert. Verschachtelte Batches und Ausgabereferenzen werden in v1 nicht unterstützt.

Repository-Struktur

• addons/godot_mcp_gateway/ — Godot-Editor-Plugin, Tool-Handler und Dock.

• packages/server/ — Gateway-Prozess, stdio-MCP-Oberfläche, IPC, Tool-Katalog, Planung, Laufzeit-Routing und LSP-Verwaltung.

• docs/ — Dokumentation zu Architektur, Protokoll, Beiträgen, Kompatibilität und lokalen Tests.

Das Repository-Stammverzeichnis ist außerdem ein kleines Godot-Projekt zum Entwickeln und Testen des Plugins. Beginnen Sie mit dem Dokumentationsindex für weiterführende Anleitungen.

Aktuelle v1-Grenzen

• Ein Gateway akzeptiert einen Godot-Editor und eine aktive Playtest-Laufzeit.

• Das Gateway wird manuell gestartet und läuft im Vordergrund.

• Ein Batch stoppt bei Fehlern, wobei jede Mutation einen eigenen Undo-Schritt behält.

• Verschachtelte Batches und Schritt-Ausgabereferenzen sind bewusst nicht unterstützt.

Namensnennung und Lizenz

Dieses Projekt ist ein aktiver Fork von NPGameDevs Godot MCP Toolkit und Godot MCP Server. Deren ausgereifter Tool-Katalog und die Editor-Integration bilden die Funktionsbasis; dieses Projekt ändert die Verbindungstopologie um sie herum.

Der Quellcode ist unter der MIT-Lizenz verfügbar. Siehe ATTRIBUTIONS.md für erhaltene Upstream-Hinweise und Drittanbieter-Anerkennungen. Geerbtes Upstream-Artwork ist Entwicklungsmaterial und nicht als unabhängiges Marken-Asset dieses Forks lizenziert; ersetzen Sie es vor der Veröffentlichung eines Marken-Releases.