Godot-MCP 代码实现解析execute_editor_script 如何动态执行任意 GDScript【免费下载链接】Godot-MCPAn MCP for Godot that lets you create and edit games in the Godot game engine with tools like Claude项目地址: https://gitcode.com/gh_mirrors/god/Godot-MCPGodot-MCP 是一个让 Claude 等 AI 助手直接操控 Godot 游戏引擎的 MCPModel Context Protocol插件。本文将深入剖析其最强大的工具——execute_editor_script看它是如何把 AI 生成的任意 GDScript 代码安全地注入 Godot 编辑器并动态执行的。一、功能定位为什么需要任意脚本执行Godot-MCP 内置了创建节点、编辑场景、管理脚本等固定工具但 Godot 编辑器 API 浩如烟海不可能每个都做成独立工具。execute_editor_script就是那个万能逃生舱只要 AI 会写 GDScript就能在编辑器上下文中执行它——查节点、改属性、批量操作统统搞定。Godot-MCP 动态执行 GDScript 架构二、命令的完整流转路径 ️一条命令从 AI 到 Godot 编辑器要经过 4 站站点文件职责MCP 工具定义editor_tools.ts向 Claude 暴露工具校验参数WebSocket 客户端godot_connection.ts发送命令并等待响应编辑器内 WebSocket 服务mcp_server.gd监听 9080 端口解析命令命令处理器editor_script_commands.gd真正执行 GDScript第 1 站工具注册与参数校验MCP 服务启动时index.tseditorTools被注册进 FastMCP。工具本身非常简洁——只有一个code参数用 zod 校验为非空字符串后直接调用godot.sendCommand(execute_editor_script, { code })。第 2 站Promise 化的 WebSocket 通信GodotConnection.sendCommand 生成递增的commandId把{type, params, commandId}序列化为 JSON 发出同时在内部队列里挂起一个 Promise——等 Godot 带着相同commandId的响应回来时自动 resolve。这样异步的 WebSocket 就变成了好用的await接口。第 3 站Godot 编辑器内的路由Godot 侧的 mcp_server.gd 在_process中轮询连接与消息。收到带type字段的旧版命令格式后通过command_received信号交给命令处理器。command_handler.gd 依次询问各处理器谁认领谁处理execute_editor_script最终被MCPEditorScriptCommands接走。三、核心实现动态脚本的三明治结构 真正的高光代码在 editor_script_commands.gd。它的思路是把用户代码夹进一个预先写好的 GDScript 模板里生成临时脚本节点执行。tool extends Node signal execution_completed var result null var _output_array [] func custom_print(values): ... # 自定义输出收集器 func run(): # USER CODE START {user_code} # ← AI 写的代码注入这里 # USER CODE END execution_completed.emit()流程分 5 步校验code为空直接返回错误L16-L17改写 print用正则print\s*\(([^)])\)把所有print(...)替换成custom_print([...])L159-L181。这样输出不再只进控制台而是被收集进_output_array能随响应返回给 AI——注意替换是倒序进行的避免字符串长度变化导致位置错乱缩进归一化把用户代码行首的空格按每 4 个换算成 1 个 Tab整体再统一缩进一级L85-L111规避 GDScript 经典的Tab/空格混用解析错误预检解析执行前调用script.reload()解析失败立即报错不污染编辑器L117-L121信号驱动收尾给临时节点挂上execution_completed信号run()跑完后由 信号回调 收集result、output、错误信息拆除临时节点再通过 _send_success 把{success, output, result/error}发回 WebSocket这套信号 临时节点 用完即毁的设计保证脚本执行不阻塞编辑器主循环也天然隔离了状态污染。四、设计亮点与工程细节输出捕获AI 的眼睛全靠print。改写为custom_print后AI 能看见自己脚本跑出了什么形成生成 → 执行 → 观察 → 修正的闭环错误不崩溃解析错误走_send_error返回结构化错误消息编辑器本身纹丝不动命令模式所有工具都是类型 参数 ID的 JSON 对象新增能力只需注册新的处理器扩展性极佳见 architecture.md 中的设计模式说明本地通信WebSocket 默认只监听 localhost:9080配合commandId匹配与 20 秒超时兼顾安全与可靠五、写在最后execute_editor_script展示了 MCP 工具的一个精髓与其列举 100 个固定操作不如开放一个受控的执行通道。它用模板注入、正则改写、缩进归一化和信号回调四个朴素技术就把AI 自由编程这件高风险的事做成了稳定、可观测、自动清理的工程化流程。如果你想给 Godot-MCP 加新命令照着 editor_script_commands.gd 抄一遍再改参数就是最快的上手路径。【免费下载链接】Godot-MCPAn MCP for Godot that lets you create and edit games in the Godot game engine with tools like Claude项目地址: https://gitcode.com/gh_mirrors/god/Godot-MCP创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考