Ermöglicht es AI Agents, Godot 4 Editor-Sessions und laufende Spiele über eine WebSocket-Bridge zu inspizieren und zu steuern.
Auch bekannt als godotbridge/addon, addon
- Stars
- 5
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 1.0.4
- Letzter Commit
- 1. Nov. 2026
- Lizenz
- MIT
Was ist GodotBridge MCP?
GodotBridge ist ein MCP server. Ermöglicht es AI Agents, Godot 4 Editor-Sessions und laufende Spiele über eine WebSocket-Bridge zu inspizieren und zu steuern.
Zusammenfassung generiert aus dem README des Projekts
Über GodotBridge MCP server
GodotBridge stellt eine Verbindung zwischen AI Agents und Godot 4 Editor-Sessions her. Es nutzt eine lokale WebSocket-Bridge, damit Clients wie Claude, Cursor oder Windsurf mit deiner Entwicklungsumgebung interagieren können. Entwickler installieren ein GDScript-Plugin direkt in ihr Godot-Projekt und starten einen Python-basierten MCP server via pip, um die Verbindung aufzubauen. Dieses Setup ermöglicht es einer KI, sowohl den Editor als auch die aktive Game-Instanz gleichzeitig zu verwalten.
Das System bietet 345 Tools, die in 36 Kategorien organisiert sind und Aufgaben wie Scene Building, Animation, Shader und Physik abdecken. Es enthält eine Runtime-Probe, die einen zweiten Kanal für die Live-Inspektion eines laufenden Spiels erstellt. Dies erlaubt es einem Agent, Inputs zu simulieren, Screenshots zu machen und Debugging-Aufgaben durchzuführen. Da das Plugin in reinem GDScript geschrieben ist, ist keine Kompilierung erforderlich und es funktioniert mit Godot 4.2 oder neuer.
Was du damit machen kannst
- 1Automatisierte Scene ConstructionEin AI Agent kann Szenen innerhalb des Godot Editors mithilfe spezialisierter Tools erstellen und organisieren.
- 2Live Game DebuggingEntwickler können eine KI nutzen, um den Zustand eines laufenden Spiels über einen dedizierten Runtime-Kanal zu inspizieren.
- 3Simulation von Spieler-InteraktionenEin AI Client kann Inputs innerhalb einer laufenden Game-Session auslösen, um Mechaniken zu testen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du GodotBridge MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenGodotBridge MCP in Claude Code installieren
$ claude mcp add addon -- uvx godotbridgeGodotBridge MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"addon": {
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}GodotBridge MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"addon": {
"type": "stdio",
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}GodotBridge MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"addon","type":"stdio","command":"uvx","args":["godotbridge"]}'GodotBridge MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"addon": {
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}GodotBridge MCP in Codex installieren
$ codex mcp add addon -- uvx godotbridgeGodotBridge MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.addon] command = "uvx" args = ["godotbridge"]
GodotBridge MCP in Gemini CLI installieren
$ gemini mcp add -s user addon uvx -- godotbridgeGodotBridge MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"addon": {
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbargodotbridge/addon is public and reachablegithub.com/godotbridge/addon ↗Bestanden
- Paket nennt dieses Repository als Quellegodotbridge names https://github.com/godotbridge/releases/releases as its sourcepypi.org/project/godotbridge/ ↗Befund
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-10github.com/godotbridge/addon ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from godotbridgeBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten32 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenGodotBridge — Godot Editor Plugin
The Godot 4.x editor addon for GodotBridge. This plugin creates a local WebSocket bridge that lets an MCP-speaking AI agent (Claude, Cursor, Windsurf, or any MCP client) inspect and control your Godot editor session and running game.
Features
- 345 tools across 36 categories — scene building, animation, shaders, physics, runtime game control, AI Image Studio, and more
- Real-time bridge — WebSocket connection between the editor and the MCP server
- Runtime probe — a second channel to the running game for live inspection, input simulation, screenshots, and debugging
- Zero compilation — pure GDScript, drop-in plugin
Installation
From Godot Asset Library (recommended)
- Open your Godot project
- Go to AssetLib tab
- Search for GodotBridge
- Click Download → Install
- Enable the plugin: Project → Project Settings → Plugins → GodotBridge → Enable
Manual installation
- Download or clone this repository
- Copy the
addons/godot_mcp_bridgefolder into your Godot project'saddons/directory - Enable the plugin: Project → Project Settings → Plugins → GodotBridge → Enable
Setup
This plugin is the editor-side half of GodotBridge. You also need the MCP server to connect your AI agent:
pip install godotbridge
Then register it with your AI client:
Claude Code:
claude mcp add godot-bridge -- godotbridge
Claude Desktop / Cursor / Windsurf:
Add to your MCP config:
{
"mcpServers": {
"godot-bridge": {
"command": "godotbridge"
}
}
}
For detailed setup instructions, visit godotbridge.com.
How it works
Your AI agent (Claude, Cursor, etc.)
│
│ MCP / stdio
▼
GodotBridge MCP Server (Python)
│
│ WebSocket · ws://127.0.0.1:8765
▼
This plugin (Godot editor)
│
│ WebSocket · ws://127.0.0.1:8766
▼
Your running game (runtime probe)
The editor plugin hosts the WebSocket server. The MCP server connects to it as a client — so the bridge survives your AI session ending and reconnects automatically.
Requirements
- Godot 4.2 or later
- GodotBridge MCP server (Python 3.10+)
License
MIT — see LICENSE for details.
Links
GodotBridge MCP Fragen
Wie füge ich GodotBridge MCP zu Claude Code hinzu?
Führe claude mcp add addon -- uvx godotbridge in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich GodotBridge MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Was sind die Systemanforderungen?
Du benötigst Godot 4.2 oder neuer und den GodotBridge MCP server, der mit Python 3.10 oder höher läuft.
Muss die Bridge kompiliert werden?
Nein, das Plugin ist in reinem GDScript geschrieben und erfordert keinerlei Kompilierung.