godot-mcp-runtime 2.0.0 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,224 +1,246 @@
1
- # Godot MCP Runtime
2
-
3
- [![npm version](https://img.shields.io/npm/v/godot-mcp-runtime)](https://www.npmjs.com/package/godot-mcp-runtime)
4
- [![npm downloads](https://img.shields.io/npm/dm/godot-mcp-runtime)](https://www.npmjs.com/package/godot-mcp-runtime)
5
- [![License: MIT](https://badgen.net/github/license/Erodenn/godot-mcp-runtime)](LICENSE)
6
- [![Node.js](https://img.shields.io/node/v/godot-mcp-runtime)](https://nodejs.org/)
7
-
8
- An [MCP](https://modelcontextprotocol.io/) server that gives AI assistants direct access to a running Godot 4.x game. Not just file editing, not just scene manipulation. Actual runtime control: input simulation, screenshots, UI discovery, and live GDScript execution while the game is running.
9
-
10
- Most Godot MCP servers operate headlessly. They can create scenes, add nodes, attach scripts. That covers a lot of ground, but stops at the editor boundary. This one doesn't. When you run a project through this server, it injects a lightweight UDP bridge as an autoload, and suddenly the AI can interact with your game the same way a player would: press keys, click buttons, read what's on screen, and run arbitrary code against the live scene tree.
11
-
12
- **The distinction matters: the AI doesn't just write your game, it can check its work.**
13
-
14
- <a href="https://glama.ai/mcp/servers/@Erodenn/godot-runtime-mcp">
15
- <img width="380" height="200" src="https://glama.ai/mcp/servers/@Erodenn/godot-runtime-mcp/badge" alt="godot-runtime-mcp MCP server" />
16
- </a>
17
-
18
- Think of it as [Playwright MCP](https://github.com/microsoft/playwright-mcp), but for Godot. Playwright lets agents verify that a web app actually works by driving a real browser. This does the same thing for games: run the project, take a screenshot, simulate input, read what's on screen, execute a script against the live scene tree. The agent closes the loop on its own changes rather than handing off to you to verify.
19
-
20
- This is not a playtesting replacement. It doesn't catch the subtle feel issues that only a human notices, and it won't tell you if your game is fun. What it does is let an agent confirm that a scene loads, a button responds, a value updated, a script ran without errors. That's a fundamentally different development workflow, and it's what this server is built for.
21
-
22
- Every operation is its own tool with only its relevant parameters — no operation discriminators, no conditional schemas. Each tool teaches agents how to use it through its description and response messages: what to call next, when to wait, and how to recover from errors.
23
-
24
- ## What It Does
25
-
26
- **Headless editing.** Create scenes, add nodes, set properties, attach scripts, connect signals, manage UIDs, validate GDScript. All the standard operations, no editor window required.
27
-
28
- **Runtime bridge.** When `run_project` is called, the server injects `McpBridge` as an autoload. This opens a UDP channel on port 9900 (localhost only) and enables:
29
-
30
- - **Screenshots:** Capture the viewport at any point during gameplay
31
- - **Input simulation:** Batched sequences of key presses, mouse clicks, mouse motion, UI element clicks by name or path, Godot action events, and timed waits
32
- - **UI discovery:** Walk the live scene tree and collect every visible Control node with its position, type, text content, and disabled state
33
- - **Live script execution:** Compile and run arbitrary GDScript with full SceneTree access while the game is running
34
-
35
- The bridge cleans itself up automatically when `stop_project` is called. No leftover autoloads, no modified project files.
36
-
37
- ## Quick Start
38
-
39
- ### Prerequisites
40
-
41
- - [Node.js](https://nodejs.org/) v18+
42
- - [Godot 4.x](https://godotengine.org/)
43
-
44
- ### Install via npm
45
-
46
- ```bash
47
- npm install -g godot-mcp-runtime
48
- ```
49
-
50
- ### Or clone from source
51
-
52
- ```bash
53
- git clone https://github.com/Erodenn/godot-mcp-runtime.git
54
- cd godot-mcp-runtime
55
- npm install
56
- npm run build
57
- ```
58
-
59
- ### Configure Your MCP Client
60
-
61
- Add the following to your MCP client config. Works with Claude Code, Claude Desktop, Cursor, or any MCP-compatible client.
62
-
63
- **If installed via npm:**
64
-
65
- ```json
66
- {
67
- "mcpServers": {
68
- "godot": {
69
- "command": "godot-mcp-runtime",
70
- "env": {
71
- "GODOT_PATH": "<path-to-godot-executable>"
72
- }
73
- }
74
- }
75
- }
76
- ```
77
-
78
- **If cloned from source:**
79
-
80
- ```json
81
- {
82
- "mcpServers": {
83
- "godot": {
84
- "command": "node",
85
- "args": ["<path-to>/godot-mcp-runtime/dist/index.js"],
86
- "env": {
87
- "GODOT_PATH": "<path-to-godot-executable>"
88
- }
89
- }
90
- }
91
- }
92
- ```
93
-
94
- If Godot is on your `PATH`, you can omit `GODOT_PATH` entirely. The server will auto-detect it. Set `"DEBUG": "true"` in `env` for verbose logging.
95
-
96
- ### Verify
97
-
98
- Ask your AI assistant to call `get_project_info`. If it returns a Godot version string (e.g., `4.4.stable`), you're connected and working.
99
-
100
- ## Tools
101
-
102
- ### Project Management
103
-
104
- | Tool | Description |
105
- |------|-------------|
106
- | `launch_editor` | Open the Godot editor GUI for a project |
107
- | `run_project` | Run a project in debug mode and inject the MCP bridge |
108
- | `stop_project` | Stop the running project and remove the bridge |
109
- | `get_debug_output` | Read stdout/stderr from the running project |
110
- | `list_projects` | Find Godot projects in a directory |
111
- | `get_project_info` | Get project metadata and Godot version |
112
-
113
- ### Runtime (requires `run_project` first)
114
-
115
- After calling `run_project`, wait 2-3 seconds for the bridge to initialize before using these tools.
116
-
117
- | Tool | Description |
118
- |------|-------------|
119
- | `take_screenshot` | Capture a PNG of the running viewport |
120
- | `simulate_input` | Send batched input: key, mouse, click_element, action, wait |
121
- | `get_ui_elements` | Get all visible Control nodes with positions, types, and text |
122
- | `run_script` | Execute arbitrary GDScript at runtime with full SceneTree access |
123
-
124
- ### Scene Editing (headless)
125
-
126
- All mutation operations save automatically. Use `save_scene` only for save-as (`newPath`) or to re-canonicalize a `.tscn` file.
127
-
128
- | Tool | Description |
129
- |------|-------------|
130
- | `create_scene` | Create a new scene file |
131
- | `add_node` | Add a node to an existing scene (supports promoted spatial params) |
132
- | `load_sprite` | Set a texture on a Sprite2D, Sprite3D, or TextureRect |
133
- | `save_scene` | Re-pack and save the scene, or save-as with `newPath` |
134
- | `export_mesh_library` | Export scenes as a MeshLibrary for GridMap |
135
- | `batch_scene_operations` | Run multiple add_node/load_sprite/save ops in a single Godot process |
136
-
137
- ### Node Editing (headless)
138
-
139
- All mutation operations save automatically.
140
-
141
- | Tool | Description |
142
- |------|-------------|
143
- | `get_scene_tree` | Get the full scene tree hierarchy (use `maxDepth: 1` for shallow listing) |
144
- | `get_node_properties` | Read properties from a node |
145
- | `batch_get_node_properties` | Read properties from multiple nodes in one process |
146
- | `set_node_property` | Set a property on a node |
147
- | `batch_set_node_properties` | Set multiple properties in one process |
148
- | `attach_script` | Attach a GDScript to a node |
149
- | `duplicate_node` | Duplicate a node within the scene |
150
- | `delete_node` | Remove a node from the scene |
151
- | `get_node_signals` | List all signals on a node with their connections |
152
- | `connect_signal` | Connect a signal to a method on another node |
153
- | `disconnect_signal` | Disconnect a signal connection |
154
-
155
- ### Project Config (no Godot process required)
156
-
157
- These tools edit `project.godot` directly or read the filesystem. Safe to use even when autoloads are broken.
158
-
159
- | Tool | Description |
160
- |------|-------------|
161
- | `list_autoloads` | List all registered autoloads with paths and singleton status |
162
- | `add_autoload` | Register a new autoload |
163
- | `remove_autoload` | Unregister an autoload by name |
164
- | `update_autoload` | Modify an existing autoload's path or singleton flag |
165
- | `get_project_settings` | Read settings from `project.godot` by section and key |
166
- | `get_project_files` | Get the project file tree with types and extensions |
167
- | `search_project` | Search for a string across project source files |
168
- | `get_scene_dependencies` | List all resources a scene depends on |
169
-
170
- ### Validation: `validate`
171
-
172
- Validate before attaching or running. Catches syntax errors and missing resource references before they cause headless crashes or runtime failures. Supports `scriptPath`, `source` (inline GDScript), `scenePath`, or a `targets` array for batch validation.
173
-
174
- ### UIDs: `manage_uids` (Godot 4.4+)
175
-
176
- | Operation | Description |
177
- |-----------|-------------|
178
- | `get` | Get a resource's UID |
179
- | `update` | Resave all resources to update UID references |
180
-
181
- ## Architecture
182
-
183
- ```
184
- src/
185
- ├── index.ts # MCP server entry point, routes tool calls
186
- ├── tools/
187
- │ ├── project-tools.ts # Project, runtime, autoload, filesystem, search, settings
188
- │ ├── scene-tools.ts # Scene creation, node addition, sprite loading, batch ops, UIDs
189
- │ ├── node-tools.ts # Node properties, scripts, tree, duplication, signals
190
- │ └── validate-tools.ts # GDScript and scene validation
191
- ├── scripts/
192
- │ ├── godot_operations.gd # Headless GDScript operations
193
- │ └── mcp_bridge.gd # UDP autoload for runtime communication
194
- └── utils/
195
- └── godot-runner.ts # Process spawning, output parsing, shared validation helpers
196
- ```
197
-
198
- Headless operations spawn Godot with `--headless --script godot_operations.gd`, perform the operation, and return JSON. Runtime operations communicate over UDP with the injected `McpBridge` autoload.
199
-
200
- ## How the Bridge Works
201
-
202
- When `run_project` is called:
203
-
204
- 1. `mcp_bridge.gd` is copied into the project directory
205
- 2. It's registered as an autoload in `project.godot`
206
- 3. The project launches with the bridge listening on `127.0.0.1:9900`
207
- 4. Runtime tools send JSON commands to the bridge and await responses
208
- 5. When `stop_project` is called, the autoload entry and bridge script are removed
209
-
210
- Files generated during runtime (screenshots, executed scripts) are stored in `.mcp/` inside the project directory. This directory is automatically added to `.gitignore` and has a `.gdignore` so Godot won't import it.
211
-
212
- ## Broken Autoloads
213
-
214
- If any registered autoload fails to initialize (syntax error, missing resource, display dependency), Godot's headless process will crash before any operation runs. Use `list_autoloads` and `remove_autoload` to inspect and remove the failing autoload. These tools edit `project.godot` directly, with no Godot process involved.
215
-
216
- ## Acknowledgments
217
-
218
- Built on the foundation laid by [Coding-Solo/godot-mcp](https://github.com/Coding-Solo/godot-mcp) for headless Godot operations.
219
-
220
- Developed with [Claude Code](https://claude.ai/code).
221
-
222
- ## License
223
-
224
- [MIT](LICENSE)
1
+ # Godot MCP Runtime
2
+
3
+ [![npm version](https://img.shields.io/npm/v/godot-mcp-runtime)](https://www.npmjs.com/package/godot-mcp-runtime)
4
+ [![npm downloads](https://img.shields.io/npm/dt/godot-mcp-runtime)](https://www.npmjs.com/package/godot-mcp-runtime)
5
+ [![License: MIT](https://badgen.net/github/license/Erodenn/godot-mcp-runtime)](LICENSE)
6
+ [![Node.js](https://img.shields.io/node/v/godot-mcp-runtime)](https://nodejs.org/)
7
+
8
+ An [MCP](https://modelcontextprotocol.io/) server that gives AI assistants direct access to a running Godot 4.x game. Not just file editing, not just scene manipulation. Actual runtime control: input simulation, screenshots, UI discovery, and live GDScript execution while the game is running.
9
+
10
+ When you run a project through this server, it injects a lightweight UDP bridge as an autoload, and suddenly the AI can interact with your game the same way a player would: press keys, click buttons, read what's on screen, and run arbitrary code against the live scene tree.
11
+
12
+ **The distinction matters: the AI doesn't just write your game, it can check its work.**
13
+
14
+ **No addon required.** Most Godot MCP servers that offer runtime support ship as a Godot addon — something you install into your project, commit to version control, and manage as a dependency. This server does none of that. The bridge script is injected on `run_project` or `attach_project`, then removed on `stop_project` or `detach_project`. Your project files are left exactly as they were. All you need is Node.js and a Godot executable, no addon installation, no project modifications, no cleanup.
15
+
16
+ Think of it as [Playwright MCP](https://github.com/microsoft/playwright-mcp), but for Godot. Playwright lets agents verify that a web app actually works by driving a real browser. This does the same thing for games: run the project, take a screenshot, simulate input, read what's on screen, execute a script against the live scene tree. The agent closes the loop on its own changes rather than handing off to you to verify.
17
+
18
+ This is not a playtesting replacement. It doesn't catch the subtle feel issues that only a human notices, and it won't tell you if your game is fun. What it does is let an agent confirm that a scene loads, a button responds, a value updated, a script ran without errors. That's a fundamentally different development workflow, and it's what this server is built for.
19
+
20
+ Every operation is its own tool with only its relevant parameters, no operation discriminators, no conditional schemas. Each tool teaches agents how to use it through its description and response messages: what to call next, when to wait, and how to recover from errors.
21
+
22
+ <a href="https://glama.ai/mcp/servers/@Erodenn/godot-runtime-mcp">
23
+ <img width="380" height="200" src="https://glama.ai/mcp/servers/@Erodenn/godot-runtime-mcp/badge" alt="godot-runtime-mcp MCP server" />
24
+ </a>
25
+
26
+ ## What It Does
27
+
28
+ **Headless editing.** Create scenes, add nodes, set properties, attach scripts, connect signals, manage UIDs, validate GDScript. All the standard operations, no editor window required.
29
+
30
+ **Runtime bridge.** When `run_project` or `attach_project` is called, the server injects `McpBridge` as an autoload. This opens a UDP channel on port 9900 (localhost only) and enables:
31
+
32
+ - **Screenshots:** Capture the viewport at any point during gameplay
33
+ - **Input simulation:** Batched sequences of key presses, mouse clicks, mouse motion, UI element clicks by name or path, Godot action events, and timed waits
34
+ - **UI discovery:** Walk the live scene tree and collect every visible Control node with its position, type, text content, and disabled state
35
+ - **Live script execution:** Compile and run arbitrary GDScript with full SceneTree access while the game is running
36
+
37
+ **Background mode.** Pass `background: true` to `run_project` and the Godot window moves off-screen with physical input blocked: borderless, unfocusable, mouse-passthrough. Programmatic input, screenshots, and all runtime tools work exactly the same. Useful for automated agent-driven testing where the window shouldn't be visible or interactive.
38
+
39
+ **Manual attach mode.** When something other than MCP launches the game (a CI pipeline, an external debugger, your own shell), call `attach_project` first. It injects the bridge and marks the project active without spawning Godot, so when you launch the game manually, runtime tools work against it. The tradeoff: `get_debug_output` is unavailable in attached mode because stdout and stderr only flow through processes MCP started itself. Use `detach_project` when done.
40
+
41
+ The bridge cleans itself up automatically when `stop_project` or `detach_project` is called. No leftover autoloads, no modified project files.
42
+
43
+ ## Quick Start
44
+
45
+ ### Prerequisites
46
+
47
+ - [Node.js](https://nodejs.org/) v18+
48
+ - [Godot 4.x](https://godotengine.org/)
49
+
50
+ That's it. No Godot addon, no project modifications.
51
+
52
+ ### Configure Your MCP Client
53
+
54
+ Add the following to your MCP client config. Works with Claude Code, Claude Desktop, Cursor, or any MCP-compatible client.
55
+
56
+ **Zero-install via npx (recommended):**
57
+
58
+ ```json
59
+ {
60
+ "mcpServers": {
61
+ "godot": {
62
+ "command": "npx",
63
+ "args": ["-y", "godot-mcp-runtime"],
64
+ "env": {
65
+ "GODOT_PATH": "<path-to-godot-executable>"
66
+ }
67
+ }
68
+ }
69
+ }
70
+ ```
71
+
72
+ **Or install globally:**
73
+
74
+ ```bash
75
+ npm install -g godot-mcp-runtime
76
+ ```
77
+
78
+ ```json
79
+ {
80
+ "mcpServers": {
81
+ "godot": {
82
+ "command": "godot-mcp-runtime",
83
+ "env": {
84
+ "GODOT_PATH": "<path-to-godot-executable>"
85
+ }
86
+ }
87
+ }
88
+ }
89
+ ```
90
+
91
+ **Or clone from source:**
92
+
93
+ ```bash
94
+ git clone https://github.com/Erodenn/godot-mcp-runtime.git
95
+ cd godot-mcp-runtime
96
+ npm install
97
+ npm run build
98
+ ```
99
+
100
+ ```json
101
+ {
102
+ "mcpServers": {
103
+ "godot": {
104
+ "command": "node",
105
+ "args": ["<path-to>/godot-mcp-runtime/dist/index.js"],
106
+ "env": {
107
+ "GODOT_PATH": "<path-to-godot-executable>"
108
+ }
109
+ }
110
+ }
111
+ }
112
+ ```
113
+
114
+ If Godot is on your `PATH`, you can omit `GODOT_PATH` entirely. The server will auto-detect it. Set `"DEBUG": "true"` in `env` for verbose logging.
115
+
116
+ ### Verify
117
+
118
+ Ask your AI assistant to call `get_project_info`. If it returns a Godot version string (e.g., `4.4.stable`), you're connected and working.
119
+
120
+ ## Tools
121
+
122
+ ### Project Management
123
+
124
+ | Tool | Description |
125
+ |------|-------------|
126
+ | `launch_editor` | Open the Godot editor GUI for a project |
127
+ | `run_project` | Run a project in debug mode and inject the MCP bridge. Pass `background: true` to hide the window |
128
+ | `attach_project` | Inject the MCP bridge for a project you'll launch yourself |
129
+ | `detach_project` | Remove the injected bridge after manual-launch use, leaving the external process alone |
130
+ | `stop_project` | Stop the running project and remove the bridge (also detaches attached-mode state) |
131
+ | `get_debug_output` | Read stdout/stderr from an MCP-spawned project (unavailable in attached mode) |
132
+ | `list_projects` | Find Godot projects in a directory |
133
+ | `get_project_info` | Get project metadata and Godot version |
134
+
135
+ ### Runtime (requires `run_project` or `attach_project` first)
136
+
137
+ After `run_project`, or after `attach_project` plus launching Godot manually, wait 2-3 seconds for the bridge to initialize before using these tools.
138
+
139
+ | Tool | Description |
140
+ |------|-------------|
141
+ | `take_screenshot` | Capture a PNG of the running viewport |
142
+ | `simulate_input` | Send batched input: key, mouse, click_element, action, wait |
143
+ | `get_ui_elements` | Get all visible Control nodes with positions, types, and text |
144
+ | `run_script` | Execute arbitrary GDScript at runtime with full SceneTree access |
145
+
146
+ ### Scene Editing (headless)
147
+
148
+ All mutation operations save automatically. Use `save_scene` only for save-as (`newPath`) or to re-canonicalize a `.tscn` file.
149
+
150
+ | Tool | Description |
151
+ |------|-------------|
152
+ | `create_scene` | Create a new scene file |
153
+ | `add_node` | Add a node to an existing scene (supports promoted spatial params) |
154
+ | `load_sprite` | Set a texture on a Sprite2D, Sprite3D, or TextureRect |
155
+ | `save_scene` | Re-pack and save the scene, or save-as with `newPath` |
156
+ | `export_mesh_library` | Export scenes as a MeshLibrary for GridMap |
157
+ | `batch_scene_operations` | Run multiple add_node/load_sprite/save ops in a single Godot process |
158
+
159
+ ### Node Editing (headless)
160
+
161
+ All mutation operations save automatically.
162
+
163
+ | Tool | Description |
164
+ |------|-------------|
165
+ | `get_scene_tree` | Get the full scene tree hierarchy (use `maxDepth: 1` for shallow listing) |
166
+ | `get_node_properties` | Read properties from a node |
167
+ | `batch_get_node_properties` | Read properties from multiple nodes in one process |
168
+ | `set_node_property` | Set a property on a node |
169
+ | `batch_set_node_properties` | Set multiple properties in one process |
170
+ | `attach_script` | Attach a GDScript to a node |
171
+ | `duplicate_node` | Duplicate a node within the scene |
172
+ | `delete_node` | Remove a node from the scene |
173
+ | `get_node_signals` | List all signals on a node with their connections |
174
+ | `connect_signal` | Connect a signal to a method on another node |
175
+ | `disconnect_signal` | Disconnect a signal connection |
176
+
177
+ ### Project Config (no Godot process required)
178
+
179
+ These tools edit `project.godot` directly or read the filesystem. Safe to use even when autoloads are broken.
180
+
181
+ | Tool | Description |
182
+ |------|-------------|
183
+ | `list_autoloads` | List all registered autoloads with paths and singleton status |
184
+ | `add_autoload` | Register a new autoload |
185
+ | `remove_autoload` | Unregister an autoload by name |
186
+ | `update_autoload` | Modify an existing autoload's path or singleton flag |
187
+ | `get_project_settings` | Read settings from `project.godot` by section and key |
188
+ | `get_project_files` | Get the project file tree with types and extensions |
189
+ | `search_project` | Search for a string across project source files |
190
+ | `get_scene_dependencies` | List all resources a scene depends on |
191
+
192
+ ### Validation: `validate`
193
+
194
+ Validate before attaching or running. Catches syntax errors and missing resource references before they cause headless crashes or runtime failures. Supports `scriptPath`, `source` (inline GDScript), `scenePath`, or a `targets` array for batch validation.
195
+
196
+ ### UIDs: `manage_uids` (Godot 4.4+)
197
+
198
+ | Operation | Description |
199
+ |-----------|-------------|
200
+ | `get` | Get a resource's UID |
201
+ | `update` | Resave all resources to update UID references |
202
+
203
+ ## Architecture
204
+
205
+ ```
206
+ src/
207
+ ├── index.ts # MCP server entry point, routes tool calls
208
+ ├── tools/
209
+ │ ├── project-tools.ts # Project, runtime, autoload, filesystem, search, settings
210
+ │ ├── scene-tools.ts # Scene creation, node addition, sprite loading, batch ops, UIDs
211
+ │ ├── node-tools.ts # Node properties, scripts, tree, duplication, signals
212
+ │ └── validate-tools.ts # GDScript and scene validation
213
+ ├── scripts/
214
+ │ ├── godot_operations.gd # Headless GDScript operations
215
+ │ └── mcp_bridge.gd # UDP autoload for runtime communication
216
+ └── utils/
217
+ └── godot-runner.ts # Process spawning, output parsing, shared validation helpers
218
+ ```
219
+
220
+ Headless operations spawn Godot with `--headless --script godot_operations.gd`, perform the operation, and return JSON. Runtime operations communicate over UDP with the injected `McpBridge` autoload.
221
+
222
+ ## How the Bridge Works
223
+
224
+ When `run_project` or `attach_project` is called:
225
+
226
+ 1. `mcp_bridge.gd` is copied into the project directory
227
+ 2. It's registered as an autoload in `project.godot`
228
+ 3. Godot launches with the bridge listening on `127.0.0.1:9900`. With `run_project`, MCP spawns the process; with `attach_project`, you launch it yourself.
229
+ 4. Runtime tools send JSON commands to the bridge and await responses
230
+ 5. `stop_project` or `detach_project` removes the bridge script and autoload entry
231
+
232
+ Files generated during runtime (screenshots, executed scripts) are stored in `.mcp/` inside the project directory. This directory is automatically added to `.gitignore` and has a `.gdignore` so Godot won't import it.
233
+
234
+ ## Broken Autoloads
235
+
236
+ If any registered autoload fails to initialize (syntax error, missing resource, display dependency), Godot's headless process will crash before any operation runs. Use `list_autoloads` and `remove_autoload` to inspect and remove the failing autoload. These tools edit `project.godot` directly, with no Godot process involved.
237
+
238
+ ## Acknowledgments
239
+
240
+ Built on the foundation laid by [Coding-Solo/godot-mcp](https://github.com/Coding-Solo/godot-mcp) for headless Godot operations.
241
+
242
+ Developed with [Claude Code](https://claude.ai/code).
243
+
244
+ ## License
245
+
246
+ [MIT](LICENSE)
package/dist/index.js CHANGED
@@ -11,7 +11,7 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
11
11
  import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError, } from '@modelcontextprotocol/sdk/types.js';
12
12
  import { GodotRunner } from './utils/godot-runner.js';
13
13
  // Project tools
14
- import { projectToolDefinitions, handleLaunchEditor, handleRunProject, handleGetDebugOutput, handleStopProject, handleListProjects, handleGetProjectInfo, handleTakeScreenshot, handleSimulateInput, handleGetUiElements, handleRunScript, handleListAutoloads, handleAddAutoload, handleRemoveAutoload, handleUpdateAutoload, handleGetProjectFiles, handleSearchProject, handleGetSceneDependencies, handleGetProjectSettings, } from './tools/project-tools.js';
14
+ import { projectToolDefinitions, handleLaunchEditor, handleRunProject, handleAttachProject, handleDetachProject, handleGetDebugOutput, handleStopProject, handleListProjects, handleGetProjectInfo, handleTakeScreenshot, handleSimulateInput, handleGetUiElements, handleRunScript, handleListAutoloads, handleAddAutoload, handleRemoveAutoload, handleUpdateAutoload, handleGetProjectFiles, handleSearchProject, handleGetSceneDependencies, handleGetProjectSettings, } from './tools/project-tools.js';
15
15
  // Scene tools
16
16
  import { sceneToolDefinitions, handleCreateScene, handleAddNode, handleLoadSprite, handleSaveScene, handleExportMeshLibrary, handleBatchSceneOperations, handleManageUids, } from './tools/scene-tools.js';
17
17
  // Node tools
@@ -25,7 +25,7 @@ class GodotMcpServer {
25
25
  this.runner = new GodotRunner(config);
26
26
  this.server = new Server({
27
27
  name: 'godot-mcp',
28
- version: '2.0.0',
28
+ version: '2.2.0',
29
29
  }, {
30
30
  capabilities: {
31
31
  tools: {},
@@ -33,10 +33,10 @@ class GodotMcpServer {
33
33
  instructions: `Godot MCP Server — AI-driven Godot 4.x project manipulation.
34
34
 
35
35
  Tool categories:
36
- - Project management: launch_editor, run_project, stop_project, get_debug_output, list_projects, get_project_info
36
+ - Project management: launch_editor, run_project, attach_project, detach_project, stop_project, get_debug_output, list_projects, get_project_info
37
37
  - Scene editing (headless): create_scene, add_node, load_sprite, save_scene, export_mesh_library, batch_scene_operations
38
38
  - Node editing (headless): delete_node, set_node_property, batch_set_node_properties, get_node_properties, batch_get_node_properties, attach_script, get_scene_tree, duplicate_node, get_node_signals, connect_signal, disconnect_signal
39
- - Runtime (requires run_project): take_screenshot, simulate_input, get_ui_elements, run_script
39
+ - Runtime (requires run_project or attach_project): take_screenshot, simulate_input, get_ui_elements, run_script
40
40
  - Project config (no Godot process): list_autoloads, add_autoload, remove_autoload, update_autoload, get_project_files, search_project, get_scene_dependencies, get_project_settings
41
41
  - Validation: validate
42
42
  - UIDs (Godot 4.4+): manage_uids
@@ -45,6 +45,7 @@ Key behaviors:
45
45
  - All mutation operations (add_node, set_node_property, delete_node, etc.) save the scene automatically. Only use save_scene for save-as (newPath) or re-canonicalization.
46
46
  - Headless Godot initializes ALL registered autoloads. If any autoload is broken, headless operations will fail. Use list_autoloads / remove_autoload to diagnose.
47
47
  - After run_project, wait 2-3 seconds before using runtime tools (take_screenshot, simulate_input, get_ui_elements, run_script). The MCP bridge needs time to initialize.
48
+ - attach_project is the fallback path for a manually launched Godot process. It injects the bridge and marks the project active, but it does not spawn Godot or capture stdout/stderr.
48
49
  - click_element in simulate_input resolves by node path or node name (BFS search), NOT by visible text. Use get_ui_elements to discover valid element identifiers.
49
50
  - run_script expects GDScript with "extends RefCounted" and "func execute(scene_tree: SceneTree) -> Variant".`,
50
51
  });
@@ -85,6 +86,10 @@ Key behaviors:
85
86
  return await handleLaunchEditor(this.runner, args);
86
87
  case 'run_project':
87
88
  return await handleRunProject(this.runner, args);
89
+ case 'attach_project':
90
+ return await handleAttachProject(this.runner, args);
91
+ case 'detach_project':
92
+ return handleDetachProject(this.runner);
88
93
  case 'get_debug_output':
89
94
  return handleGetDebugOutput(this.runner, args);
90
95
  case 'stop_project':
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -5,6 +5,7 @@ var port: int = 9900
5
5
  var _is_processing_input: bool = false
6
6
 
7
7
  func _ready() -> void:
8
+ process_mode = Node.PROCESS_MODE_ALWAYS
8
9
  udp_server = UDPServer.new()
9
10
  var err = udp_server.listen(port, "127.0.0.1")
10
11
  if err != OK:
@@ -12,6 +13,13 @@ func _ready() -> void:
12
13
  else:
13
14
  print("McpBridge: Listening on UDP port %d" % port)
14
15
 
16
+ if OS.get_environment("MCP_BACKGROUND") == "1":
17
+ DisplayServer.window_set_flag(DisplayServer.WINDOW_FLAG_NO_FOCUS, true)
18
+ DisplayServer.window_set_flag(DisplayServer.WINDOW_FLAG_MOUSE_PASSTHROUGH, true)
19
+ DisplayServer.window_set_flag(DisplayServer.WINDOW_FLAG_BORDERLESS, true)
20
+ DisplayServer.window_set_position(Vector2i(-9999, -9999))
21
+ print("McpBridge: Background mode active - window hidden, physical input blocked")
22
+
15
23
  func _process(_delta: float) -> void:
16
24
  udp_server.poll()
17
25
  if udp_server.is_connection_available():
@@ -24,6 +24,30 @@ export declare function handleRunProject(runner: GodotRunner, args: OperationPar
24
24
  text: string;
25
25
  }[];
26
26
  }>;
27
+ export declare function handleAttachProject(runner: GodotRunner, args: OperationParams): Promise<{
28
+ content: Array<{
29
+ type: "text";
30
+ text: string;
31
+ }>;
32
+ isError: boolean;
33
+ } | {
34
+ content: {
35
+ type: string;
36
+ text: string;
37
+ }[];
38
+ }>;
39
+ export declare function handleDetachProject(runner: GodotRunner): {
40
+ content: Array<{
41
+ type: "text";
42
+ text: string;
43
+ }>;
44
+ isError: boolean;
45
+ } | {
46
+ content: {
47
+ type: string;
48
+ text: string;
49
+ }[];
50
+ };
27
51
  export declare function handleGetDebugOutput(runner: GodotRunner, args?: OperationParams): {
28
52
  content: Array<{
29
53
  type: "text";