1  # Godot MCP Pro
 2  
 3  > 162 AI-powered tools connecting Claude, Cursor, and AI assistants to the Godot 4 editor via the Model Context Protocol (MCP).
 4  
 5  ## Overview
 6  
 7  Godot MCP Pro is an MCP server that gives AI assistants real-time access to the Godot 4 editor through a WebSocket connection. The AI can create scenes, edit scripts, simulate player input, inspect running games, build 3D environments, set up physics, add particles, manage audio, and more — all from a single conversation.
 8  
 9  ## Architecture
10  
11  AI Assistant <--stdio/MCP--> Node.js Server (TypeScript) <--WebSocket:6505--> Godot Editor Plugin (GDScript)
12  
13  The Godot plugin runs a WebSocket server inside the editor. The MCP server connects to it and translates MCP tool calls into editor commands. All mutations go through Godot's UndoRedo system.
14  
15  ## 162 Tools across 23 Categories
16  
17  - Project (7): project info, filesystem tree, file search, project settings, UID conversion
18  - Scene (9): scene tree, create/open/delete/save, play/stop, instancing
19  - Node (11): add/delete/rename/duplicate/move, properties, signals, anchors, resources
20  - Script (6): list/read/create/edit scripts, attach to nodes
21  - Editor (9): screenshots, visual diff, GDScript execution, error log, signals inspector
22  - Input Simulation (5): keyboard, mouse, InputAction, multi-event sequences
23  - Runtime Analysis (15): game scene tree, runtime properties, frame capture, input recording/replay, UI detection
24  - Animation (6): create animations, add tracks, insert keyframes
25  - AnimationTree (8): state machines, transitions, blend trees, tree parameters
26  - TileMap (6): set/fill/query cells, tile set info
27  - 3D Scene (6): mesh primitives, .glb/.gltf import, lighting, PBR materials, environment, cameras, GridMap
28  - Physics (6): collision shapes, physics layers, raycasts, body configuration
29  - Particles (5): GPU particles 2D/3D, material config, color gradients, presets
30  - Navigation (5): navigation regions, mesh baking, pathfinding agents, layer management
31  - Audio (6): audio bus layout, effects, 2D/3D players
32  - Theme & UI (6): colors, constants, font sizes, StyleBoxFlat
33  - Shader (6): create/edit shaders, assign materials, set/get uniforms
34  - Resource (3): read/edit/create .tres resource files
35  - Batch & Refactoring (6): find by type, signal audit, batch property set, cross-scene changes
36  - Testing & QA (5): automated test scenarios, assertions, stress testing
37  - Code Analysis (6): unused resources, signal flow, scene complexity, circular dependencies
38  - Profiling (2): FPS, memory, draw calls, physics monitors
39  - Export (3): export presets, export commands
40  
41  ## Requirements
42  
43  - Godot 4.4+ (tested on 4.6)
44  - Node.js 18+
45  - Any MCP-compatible AI client (Claude Code, Claude Desktop, Cursor, VS Code + Cline, Windsurf)
46  
47  ## Setup
48  
49  1. Copy addons/godot_mcp/ into your Godot project
50  2. Enable plugin: Project > Project Settings > Plugins > Godot MCP Pro
51  3. Build MCP server: cd server && npm install && npm run build
52  4. Add to .mcp.json: {"mcpServers": {"godot-mcp-pro": {"command": "node", "args": ["/path/to/server/build/index.js"]}}}
53  
54  ## Pricing
55  
56  $15 one-time purchase. Lifetime updates for v1.x. Unlimited projects and machines.
57  
58  ## Links
59  
60  - Website: https://godot-mcp.abyo.net/
61  - Buy (itch.io): https://y1uda.itch.io/godot-mcp-pro
62  - Buy (BMC): https://buymeacoffee.com/y1uda/e/512940
63  - GitHub: https://github.com/youichi-uda/godot-mcp-pro
64  - Discord: https://discord.gg/F4gR739y