wgt19861219/godot-mcp-enhanced

claude mcp add -s user godot -- npx -y godot-mcp-enhanced
For Cursor/Cline/Windsurf add {"mcpServers":{"godot":{"command":"npx","args":["-y","godot-mcp-enhanced"]}}}
npx godot-mcp-enhanced setup for one-click auto-detection

Usage

• •Run setup_project_rules(project_path=...) after connecting to generate CLAUDE.md/AGENTS.md and hooks
• •Use read_scene / write_script / run_and_verify / validate_scripts / verify_delivery for the edit-run-verify loop
• •Game Bridge tools query a running game over TCP: game_query, game_input, game_wait
• •Set GODOT_PATH, GODOT_PROJECT_PATH or per-project godot_path for multi-version Godot

Key features

• ✓40 merged MCP tools (210 actions) covering scenes, scripts, UI, animation, physics, particles, navigation, audio, tests, export and 3D parametric assets
• ✓Engine-level runtime control: read node trees, GPU screenshots, input simulation, recording/replay and frame-verify
• ✓Security: ALLOWED_PROJECT_PATHS whitelist, Godot binary allowlist, GDScript injection defense, confirmation tokens and output anti-forgery
• ✓verify_delivery end-to-end delivery gate, dev_loop and chain_verify self-questioning engine
• ✓godot:// resources for reading project context without explicit tool calls

Best for

AI-assisted Godot 4.x game development with closed edit-run-verify loops and safety guards.

Caveats

• ⚠GDScript has full system access; the sandbox is a mistake-prevention layer, not an unbypassable boundary
• ⚠Only for local trusted environments; no remote authentication or encryption
• ⚠Runtime tools only affect the headless execution context and do not persist to .tscn
• ⚠update-checker fetches the npm registry at startup unless GODOT_MCP_UPDATE_CHECK=false