Godot MCP Pro

Premium MCP (Model Context Protocol) server for AI-powered Godot game development. Connects AI assistants like Claude directly to your Godot editor with175 powerful tools.

AI Assistant ←—stdio/MCP—→ Node.js Server ←—WebSocket:6505—→ Godot Editor Plugin

- Real-time: WebSocket connection means instant feedback, no file polling
- Editor Integration: Full access to Godot's editor API, UndoRedo system, and scene tree
- JSON-RPC 2.0: Standard protocol with proper error codes and suggestions

⚠️This public repo only contains the free Godot addon/plugin.The MCP server (Node.js, required to connect AI assistants) is distributed as part of the paid package —one-time purchase, lifetime updates:

- Buy Me a Coffee:https://buymeacoffee.com/y1uda/extras
- itch.io:https://y1uda.itch.io/godot-mcp-pro

{ "mcpServers": { "godot-mcp-pro": { "command": "node", "args": ["/path/to/server/build/index.js"], "env": { "GODOT_MCP_PORT": "6505" } } } }

Godot MCP Pro offers four modes to fit any client's tool limit:

{ "mcpServers": { "godot-mcp-pro": { "command": "node", "args": ["/path/to/server/build/index.js", "--lite"] } } }

Replace--litewith--minimalfor the smallest footprint.

- Liteincludes: project, scene, node, script, editor, input, runtime, and input_map tools.
- Minimalincludes: 35 essential tools — project info, scene management, node CRUD, script editing, editor errors, input simulation, and runtime inspection.

For clients without MCP support, or when you want zero context overhead, use the CLI directly from a terminal/bash tool. The CLI requires the server to be built first (Step 2).

# Top-level help — shows all command groups node /path/to/server/build/cli.js --help # Group help — shows commands in a group node /path/to/server/build/cli.js node --help # Command help — shows options for a command node /path/to/server/build/cli.js node add --help # Execute node /path/to/server/build/cli.js project info node /path/to/server/build/cli.js scene play node /path/to/server/build/cli.js node add --type CharacterBody3D --name Player

Replace/path/to/with the actual path where you extracted the files.

The CLI connects directly to the Godot editor plugin via WebSocket. It requires:

- Godot editor running with the MCP plugin enabled
- Server built (node build/setup.js install)
- An available port in the 6510-6514 range

Advantage: LLMs discover capabilities progressively via--helpinstead of loading all tool definitions upfront. This works with any LLM client that has terminal access, regardless of tool count limits.

Open your Godot project with the plugin enabled, then use Claude Code to interact with the editor.

- UndoRedo Integration: All node/property operations support Ctrl+Z
- Smart Type Parsing:"Vector2(100, 200)","#ff0000","Color(1,0,0)"auto-converted
- Auto-Reconnect: Exponential backoff reconnection (1s → 2s → 4s ... → 60s max)
- Heartbeat: 10s ping/pong keeps connection alive
- Helpful Errors: Error responses include suggestions for next steps

Exclusive Categories (No Competitor Has These)

Proprietary — seeLICENSEfor details. Purchase includes lifetime updates.

MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent