godot-mcp-bridge
Free, open-source (MIT) MCP server + Godot 4 editor addon that lets AI assistants (Claude Code, etc.) drive the Godot editor and running games: create scenes, edit scripts, simulate input, screenshot gameplay, run test scenarios — 174 tools.
Status: spec phase. This repo is built spec-first: SPEC.md is the master contract; specs/ holds self-contained work packages designed to be implemented by AI agents in parallel. Sibling project: aseprite-mcp-bridge.
Architecture
Claude / MCP client ── stdio ── godot-mcp-bridge (Node, listens ws://127.0.0.1:6505-6509)
▲
│ WebSocket JSON-RPC 2.0 (addon dials out)
Godot editor addon (GDScript)
│ file IPC in user://
running game (injected autoloads)
Build order
| Phase | Spec | What |
|---|---|---|
| A | specs/A1-ts-core.md, specs/A2-addon-core.md |
frozen foundations (2 agents, parallel) |
| B | specs/B01…B13 |
13 independent tool packages, 174 tools (parallel) |
| C | specs/C1-integration.md |
schema/e2e tests, docs |
| D | specs/D1-live-e2e.md |
real-Godot validation |
Each B package touches only its own files; registry/router are pre-stubbed in Phase A so parallel agents never conflict.
License
MIT — see LICENSE. Clean-room implementation: tool surface is API-compatible with a commercial product, code is original.
