Godot MCP运行时
轻量级 主控程序 服务器，将全面的无头编辑与对 戈多 4.x项目。场景、节点、自动加载和验证操作涵盖了引擎中最小众的角落之外的所有内容；运行时桥在运行场景树上添加了屏幕截图、输入模拟、UI发现和实时GDScript。
The AI doesn't just write your game, it can check its work.
- 无头编辑 --场景、节点、脚本、信号、验证，无编辑器窗口
- 运行控制 --屏幕截图、输入模拟、UI发现和运行游戏的实时GDScript
- 零足迹 --无Godot插件，无项目提交，关机时自动清理
不需要插件。 大多数提供运行时支持的Godot MCP服务器都是作为Godot插件提供的，您可以将其安装到项目中，提交版本控制，并作为依赖项进行管理。使用npx，无需安装或设置。
把它看作是 剧作家MCP，但戈多。这对游戏来说也是一样的：运行项目，截图，模拟输入，阅读屏幕上的内容，对实时场景树执行脚本。代理根据自己的更改关闭循环，而不是交给您进行验证。
\[！注意\] 这不是游戏测试的替代品。它不会捕捉到只有人类才会注意到的微妙的感觉问题，也不会告诉你你的游戏是否有趣。它的作用是让代理确认场景已加载，按钮已响应，值已更新，脚本已无错误运行。检查工作的能力对于人工智能驱动的工作流程至关重要。
目录
它的作用
专为特工打造。 每个工具都是专门构建和自我记录的。当某个东西失败时，响应告诉代理如何修复它；当某事成功时，它指向下一步。其结果是，人工智能可以保持不卡住状态并自我纠正，而不需要你推动它。
无头编辑。 创建场景、添加节点、设置属性、附加脚本、连接信号、验证GDScript。所有标准操作，无需编辑器窗口。
运行时桥。 当 run_project 或 attach_project 被调用时，服务器注入 McpBridge 作为自动加载。这将打开一个仅限本地主机的TCP侦听器（在以下情况下都会自动选择空闲端口 bridgePort 省略；通过 bridgePort 以固定特定端口），并启用：
- 屏幕截图： 捕获视口——默认情况下，返回960x540的内联预览以及磁盘上的完整PNG；使用
responseMode: 'full'像素完美或'path_only'跳过内联图像 - 输入模拟： 按键、鼠标点击、鼠标移动、按名称或路径单击UI元素、Godot动作事件和定时等待的批处理序列
- UI发现： 遍历实时场景树，收集每个可见的Control节点及其位置、类型、文本内容和禁用状态
- 实时脚本执行： 在游戏运行时，编译并运行具有完全SceneTree访问权限的任意GDScript
背景模式。 通过 background: true 到 run_project Godot窗口移出屏幕（位于 (-9999, -9999))物理输入被阻止：无边界、不可聚焦、鼠标通过。程序化输入、屏幕截图和所有运行时工具的工作原理完全相同。对于窗口不应可见或交互式的自动化代理驱动测试非常有用。
手动连接模式。 当MCP以外的东西启动游戏时（CI管道、外部调试器、您自己的shell），调用 attach_project 第一。它注入桥并将项目标记为活动状态，而不会生成Godot，因此当您手动启动游戏时，运行时工具会对其起作用。使用 detach_project 当完成时。
\[！重要\]get_debug_output在连接模式下不可用。stdout和stderr只流经MCP自己启动的进程，因此当从外部启动Godot时，没有捕获的输出返回。使用run_project如果你需要调试流。
桥在以下情况下会自动清理 stop_project 或 detach_project 被称为。没有剩余的自动加载，没有修改过的项目文件。
快速开始
先决条件
- v20+
- 戈多4.x
就是这样。没有Godot插件，没有项目修改。
配置您的MCP客户端
将以下内容添加到MCP客户端配置中。适用于Claude Code、Claude Desktop、Cursor或任何兼容MCP的客户端。
通过npx进行零安装（推荐）：
{
"mcpServers": {
"godot": {
"command": "npx",
"args": ["-y", "godot-mcp-runtime"],
"env": {
"GODOT_PATH": "
"
}
}
}
}或全局安装：
npm install -g godot-mcp-runtime{
"mcpServers": {
"godot": {
"command": "godot-mcp-runtime",
"env": {
"GODOT_PATH": "
"
}
}
}
}或从源代码克隆：
git clone https://github.com/Erodenn/godot-mcp-runtime.git
cd godot-mcp-runtime
npm install
npm run build{
"mcpServers": {
"godot": {
"command": "node",
"args": ["
/godot-mcp-runtime/dist/index.js"],
"env": {
"GODOT_PATH": "
"
}
}
}
}\[！提示\] 更喜欢pnpm？ 所有三个安装路径都适用于pnpm。替代pnpm dlx godot-mcp-runtime为了npx -y godot-mcp-runtime,pnpm add -g godot-mcp-runtime对于全局安装，或pnpm install && pnpm run build对于源代码构建。pnpm针对npm供应链攻击提供了更强的默认值；看见 .
如果Godot在您的 PATH，您可以省略 GODOT_PATH 完全。服务器将自动检测它。设置 "DEBUG": "true" 在 env 用于详细日志记录。
验证
让你的AI助手打电话 get_project_info如果它返回Godot版本字符串（例如。， 4.4.stable)，你已连接并正在工作。
文档
docs/tools.md--按类别分组的完整工具参考docs/tool-authoring.md--添加或修改工具的标准docs/architecture.md--源代码布局、桥接序列图、生命周期步骤、运行时工件行为
致谢
建在以下基础上 编程独奏/godot mcp 用于无头Godot操作。
与开发 克劳德代码.