An AI-powered MCP server for Godot 4 that bridges AI assistants to the Godot editor via real-time WebSocket, exposing 172 tools for scene building, node management, runtime debugging, automated QA, and cross-platform deployment.
Godot MCP Pro connects AI coding assistants like Claude Code, Cursor, and Cline directly to the Godot 4 editor via Model Context Protocol, enabling natural-language-driven game development. It uses a three-layer bridge architecture: AI assistants communicate with the Node.js MCP Server via stdio/MCP, the MCP Server connects to the Godot editor plugin (GDScript) over WebSocket (JSON-RPC 2.0), and the plugin calls Godot editor APIs to execute operations.
Core Capabilities#
- 172 MCP tools (Full mode) across 25+ categories: project management, scene tree, node properties, scripts, animation, TileMap, Shader, physics, 3D scenes, particle systems, navigation, audio, export/deployment, etc.
- UndoRedo integration for all node/property operations (Ctrl+Z)
- Smart type parsing: auto-converts strings like
"Vector2(100, 200)","#ff0000","Color(1,0,0)"to Godot native types - Batch refactoring: cross-scene property modification, node reference lookup, circular dependency detection
Connectivity#
- Real-time WebSocket (default port 6505) with no file polling
- Exponential backoff auto-reconnection (1s → 2s → 4s → … → 60s max)
- 10s ping/pong heartbeat keepalive
- JSON-RPC 2.0 standard protocol with proper error codes and suggestions
Runtime Capabilities#
- Game input simulation (keyboard, mouse, Godot Input Actions) with recording/playback
- Performance monitoring: FPS, memory, physics metrics in real-time
- Editor viewport and in-game screenshots
- QA features: node state assertions, screen text detection, screenshot comparison, stress testing
- One-click Android remote deployment (export → adb install → launch)
Modes & Configuration#
Four runtime modes accommodate different AI client tool count limits: Full (172 tools), 3D (100), Lite (81), Minimal (35). CLI mode enables direct terminal invocation for clients without MCP support, with progressive capability discovery via --help. Configuration requires only the GODOT_MCP_PORT environment variable (default 6505, auto-scans 6505–6509) and mode flags.
Client Compatibility#
| Client | Recommended Mode |
|---|---|
| Claude Code | Full |
| VS Code Copilot | Full |
| Cline | Full |
| Cursor | Full |
| Windsurf | Lite |
| Gemini CLI | Lite |
| OpenCode / Local LLMs | Minimal/CLI |
Distribution Model#
The Godot plugin (addons/godot_mcp/) is open-sourced on GitHub under MIT; the MCP Server (TypeScript/Node.js) is proprietary, available as a one-time $5 purchase (includes lifetime updates). The public repo contains only the plugin code; TypeScript source visibility in the paid package is unconfirmed.
Unconfirmed Details#
- Whether the paid package includes TypeScript source (README mentions only pre-built JavaScript)
- Windsurf/JetBrains Junie compatibility based on community feedback, not officially verified
- Exact Godot 4 sub-version compatibility range unspecified
- Runtime IPC file format and concurrency safety mechanisms undocumented