youichi-uda/godot-mcp-pro
162 MCP tools for AI-powered Godot 4 development. Scene, animation, 3D, physics, particles, audio, shader, input simulation, runtime analysis, navigation, testing & more. $15 one-time.
548 ★71 forksGDScriptUpdated 5d ago
What you need to know
Premium (paid) MCP server for AI-powered Godot game development — connects AI assistants like Claude directly to the Godot editor over a real-time WebSocket, exposing 175 tools covering every stage from scene editing to testing and QA.
Install
Purchase the full package (one-time payment, lifetime updates) from Buy Me a Coffee (buymeacoffee.com/y1uda/extras) or itch.io (y1uda.itch.io/godot-mcp-pro) — the public repo only contains the free Godot addon Copy addons/godot_mcp/ into your Godot project's addons/ directory and enable the plugin (Project -> Project Settings -> Plugins) cd server && npm install && npm run build (server/ is only in the paid package)
Usage
- •Add to .mcp.json: {"mcpServers": {"godot-mcp-pro": {"command": "node", "args": ["/path/to/server/build/index.js"], "env": {"GODOT_MCP_PORT": "6505"}}}}
- •Choose a mode: Full (default, 175 tools), --3d (103), --lite (84), --minimal (35) depending on the client's tool limit
- •Alternative CLI mode (no MCP needed): node /path/to/server/build/cli.js project info / node add --type CharacterBody3D --name Player
- •Requires the Godot editor running with the MCP plugin enabled; server built via node build/setup.js install
Key features
- ✓175 tools across ~25 categories: project, scene, node, script, editor, input, runtime, animation, TileMap, theme/UI, shader, export, resource, physics, 3D scene, particles, navigation, audio, AnimationTree/state machines, analysis, testing/QA
- ✓Real-time WebSocket (port 6505) connection to the editor with JSON-RPC 2.0, no file polling
- ✓UndoRedo integration (all node/property operations support Ctrl+Z), smart type parsing (Vector2, Color, hex), auto-reconnect with exponential backoff, 10s heartbeat
- ✓Runtime inspection and control: game scene tree, input recording/replay, UI element finding, navigation agents
- ✓Four tool-count modes (175/103/84/35) to fit any client's tool limit; CLI mode for clients with terminal only
Best for
AI-assisted Godot game development — having Claude Code/Cursor build scenes, write scripts, set up physics/navigation/UI, and run automated test scenarios inside the live editor.
Caveats
- ⚠Proprietary and paid: the MCP server is only distributed in the paid package (one-time purchase, lifetime updates); license is proprietary
- ⚠Requires the Godot editor running with the plugin enabled
- ⚠Not open source — the public repo contains only the free addon/plugin
Platforms: Windows · macOS · LinuxClients: Claude Code · Cline · VS Code Copilot · Cursor · Windsurf · JetBrains Junie · Gemini CLI · OpenAI Codex CLI · Roo Code · OpenCode · LM Studio
Reviewed 2026-08-07
Topics
aiai-toolsclaudecursorgame-developmentgamedevgdscriptgodotgodot-enginegodot-plugingodot4mcpmodel-context-protocol
- Stars
- 548★
- Forks
- 71
- Language
- GDScript
- License
- NOASSERTION
- Created
- 2026-02-24
- Last push
- 2026-08-01