SuperAPI AI 工具集

godot-interactive

智能体与模型

查看项目

更新于 10-15 17:25

技能介绍

用途:让智能体驱动正在运行的 Godot 游戏,完成启动、查看、点击、检查场景树、读写属性、调用方法和执行开发控制台命令,形成观察—交互—观察循环,替代可验证部分的手动试玩。

组成:godot-mcp 是 Node MCP 服务器,负责生成/结束 Godot 进程、捕获 stdout,并把文件协议包装成 game_* 工具;GodotMCPBridge 是游戏内 GDScript 自动加载,每帧轮询命令文件,执行后写回响应和截图。所有交互都经过桥接层;若桥未加载,game_* 工具会超时,而 run_project 仍显示成功。

主要能力:run_project、get_debug_output、stop_project 控制进程;game_screenshot、game_scene_tree、game_click、game_key、game_action、game_get_property、game_set_property、game_call_method、game_console、game_type_text 进行交互。另有离线工具 create_scene、add_node、load_sprite、save_scene 等。

使用方式:构建服务器用 cd <godot-mcp> && npm install && npm run build;从 assets/templates/godot_mcp_bridge.gd 复制桥接文件。典型流程为 run_project 后等待约 3 秒,用 get_debug_output 确认 “Godot MCP Bridge initialized”,再执行 game_set_property 开启 screenshots_enabled,随后通过 game_console 驱动游戏。

限制:MCP 只能启动自己的 Godot 进程,无法附着到编辑器按 F5 启动的游戏;代码改动需完整重启,调试运行不热重载 GDScript;截图可能过期,窗口被遮挡时不会渲染,异步切换会返回过渡帧,重启后磁盘可能残留旧帧;截图会被缩放到画布尺寸,不适合作为交付资产;game_type_text 依赖焦点,不可靠;shader 材质不是节点,无法实时调参。headless Godot 在沙箱下可能崩溃或挂起。具体分类依据资料未明确给出。