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
View on GitHub ↗
Stars
548★
Forks
71
Language
GDScript
License
NOASSERTION
Created
2026-02-24
Last push
2026-08-01