youichi-uda/godot-mcp-pro

Godot MCP Pro – AI‑powered Godot editor bridge

What it is – A paid add‑on that lets large‑language‑model assistants (Claude, Copilot, Cursor, etc.) control the Godot editor in real‑time. It does this through a Model Context Protocol (MCP) server written in Node.js that talks to the editor plugin over a WebSocket (default port 6505). The server exposes 187 JSON‑RPC tools covering project management, scene graph manipulation, scripting, editor UI, input simulation, runtime inspection, animation, physics, export, testing and more.

Why it matters – By exposing the full editor API as RPC calls, an LLM can see the project structure, edit nodes, run scripts, capture screenshots, simulate input, and even deploy to Android – all without the model having to read or write files directly. This enables truly interactive, code‑free game development where the AI can iterate, test, and debug inside the editor just like a human.

How it works

1. Install the Godot plugin – copy addons/godot_mcp/ into your project and enable it in the editor settings.
2. Run the MCP server – the server is shipped only in the paid package. After extracting, npm install && npm run build produces a build/index.js executable.
3. Configure an AI client – add a mcpServers.godot‑mcp‑pro entry to a .mcp.json file pointing at the built Node script (optionally with --lite, --minimal, or --3d flags to limit the tool set for models that have a low context window).
4. Connect – the AI assistant talks to the server via stdio/MCP; the server forwards JSON‑RPC calls over the WebSocket to the Godot plugin, which executes the requested editor actions.
5. Use – from the AI side you can invoke any of the 187 tools, e.g. project info, node add --type CharacterBody3D --name Player, simulate_key "Space", run_test_scenario, or deploy_to_android.

Modes & tool‑count limits

Mode	Tools exposed	Typical client
Full (default)	187	Claude Code, VS Code Copilot, Cursor (no hard limit)
3D (--3d)	100	Clients that need 3‑D tools but cap at 100
Lite (--lite)	88	Windsurf, JetBrains Junie, Gemini CLI
Minimal (--minimal)	35	OpenCode, local LLMs with tiny context windows

Key capabilities

• Undo/Redo integration – every change can be undone with Ctrl+Z.
• Smart type parsing – strings like "Vector2(100,200)" or "#ff0000" are automatically converted to Godot types.
• Auto‑reconnect & heartbeat – resilient connection handling.
• Helpful error messages – suggestions for next steps are included in RPC error responses.
• CLI fallback – a command‑line client (cli.js) can drive the same tools without MCP, useful for terminal‑only environments.

Installation checklist

1. Purchase the full package (Buy Me a Coffee or itch.io) to obtain the server/ folder.
2. Copy the addons/godot_mcp/ directory into your Godot project and enable the plugin.
3. Build the Node server (npm install && npm run build).
4. Add the appropriate entry to .mcp.json (choose mode flags as needed).
5. Start Godot, keep the editor open, and run your AI assistant.

License & distribution – The plugin code in this public repository is free and open‑source. The MCP server binary and full feature set are distributed only with the paid package; the repository explicitly states that the server/ directory is omitted from the public repo.

---

Godot MCP Pro is a genuine AI‑focused tool that bridges large language models with the Godot game engine, giving developers (or AI assistants) programmatic, real‑time control over virtually every aspect of a Godot project.