Godot MCP Pro

1# Godot MCP Pro
2 
3**84 AI-powered tools** connecting Claude, Cursor, and other AI assistants directly to your Godot editor.
4 
5[![Buy on Buy Me a Coffee](https://img.shields.io/badge/Buy-$5_one--time-478cbf?style=for-the-badge)](https://buymeacoffee.com/y1uda/e/512940)
6[![Website](https://img.shields.io/badge/Website-godot--mcp.abyo.net-478cbf?style=for-the-badge)](https://godot-mcp.abyo.net/)
7 
8## Architecture
9 
10```
11AI Assistant <--stdio/MCP--> Node.js Server <--WebSocket:6505--> Godot Editor Plugin
12```
13 
14Real-time bidirectional communication. No file polling. No CLI subprocess spawning.
15 
16## 84 Tools across 14 Categories
17 
18| Category | Tools | Highlights |
19|----------|:-----:|------------|
20| **Project** | 7 | Read/write project settings, file search, UID conversion |
21| **Scene** | 9 | Live scene tree, create/open/delete, play/stop, instancing |
22| **Node** | 11 | Add/delete/rename/duplicate/move, properties, signals, anchors |
23| **Script** | 6 | List/read/create/edit scripts, attach to nodes |
24| **Editor** | 8 | Screenshots, GDScript execution, error log, signals inspector |
25| **Input Simulation** | 5 | Keyboard, mouse, InputAction, multi-event sequences |
26| **Runtime Analysis** | 4 | Game scene tree, runtime properties, frame capture, property monitor |
27| **Animation** | 6 | Create animations, add tracks, insert keyframes programmatically |
28| **TileMap** | 6 | Set/fill/query cells, tile set info, bulk operations |
29| **Theme & UI** | 6 | Colors, constants, font sizes, StyleBoxFlat, theme inspector |
30| **Shader** | 6 | Create/edit shaders, assign materials, set/get uniforms |
31| **Batch & Refactoring** | 5 | Find by type, signal audit, batch property set, dependency analysis |
32| **Profiling** | 2 | FPS, memory, draw calls, physics monitors |
33| **Export** | 3 | List presets, export commands, template info |
34 
35## Key Features
36 
37- **Full Undo/Redo** - All mutations go through Godot's UndoRedo system
38- **Smart Type Parsing** - `"Vector2(100,200)"`, `"#ff0000"`, `"Color(1,0,0)"` auto-converted
39- **Auto-Reconnect** - Exponential backoff (1s -> 60s max)
40- **Heartbeat** - 10s ping/pong keeps connection alive
41- **Contextual Errors** - Structured error codes with actionable suggestions
42- **Port Auto-Scan** - Tries ports 6505-6509, no configuration needed
43 
44## Comparison
45 
46| | Godot MCP Pro | Best Free Alternative |
47|---|:---:|:---:|
48| **Total Tools** | **84** | 32 |
49| **Undo/Redo** | Yes | No |
50| **Signal Management** | Yes | No |
51| **Input Simulation** | Key/Mouse/Action/Sequence | No |
52| **Runtime Inspection** | Scene tree + Properties + Frames | No |
53| **Animation Tools** | Yes | No |
54| **TileMap Tools** | Yes | No |
55| **Shader Tools** | Yes | No |
56| **Profiling** | Yes | No |
57 
58## Requirements
59 
60- Godot 4.4+ (tested on 4.6)
61- Node.js 18+
62- Any MCP-compatible AI client (Claude Code, Claude Desktop, Cursor, VS Code + Cline, etc.)
63 
64## Installation
65 
661. **Download** from [Buy Me a Coffee](https://buymeacoffee.com/y1uda/e/512940) ($5 one-time, lifetime updates for v1.x)
672. **Copy** `addons/godot_mcp/` into your Godot project
683. **Enable** the plugin: Project > Project Settings > Plugins > Godot MCP Pro
694. **Install** the MCP server:
70   ```bash
71   cd server
72   npm install
73   npm run build
74   ```
755. **Configure** your AI client's `.mcp.json`:
76   ```json
77   {
78     "mcpServers": {
79       "godot-mcp-pro": {
80         "command": "node",
81         "args": ["/path/to/server/build/index.js"]
82       }
83     }
84   }
85   ```
866. **Use it** - Open Godot with the plugin enabled, then interact via your AI assistant
87 
88## Links
89 
90- [Website](https://godot-mcp.abyo.net/)
91- [Buy ($5)](https://buymeacoffee.com/y1uda/e/512940)
92- [Issues & Feature Requests](https://github.com/youichi-uda/godot-mcp-pro/issues)
93 
94## License
95 
96Proprietary. One-time purchase includes lifetime updates for v1.x. Unlimited projects and machines.
97