Funplay 的引擎 MCP 系列从 Unity 起步，扩展到了 Cocos，这次轮到 Godot。三者共用同一套设计取向：默认工具面收敛、一键配置 AI 客户端、以一个高灵活度执行工具为主线。但每个引擎的编辑器环境不同，落地细节也就不同——Godot 这一版有几个值得单独说的设计。

Funplay MCP for Godot 是一个 MIT 协议的 Godot 编辑器 MCP server，让 Claude Code、Cursor、Windsurf、Codex、VS Code Copilot 等 AI 助手直接在你正在运行的 Godot 项目内部工作。它工作在标准的 Godot 4.2+ 项目，也可用于 Godot .NET 项目。

一个 Godot 编辑器插件

安装就是普通的 Godot addon：把 addons/funplay_mcp 放进项目的 res://addons/ 目录（也可以直接下载 Release 里的 zip 解压，或克隆仓库当 Godot 项目打开）。然后在 Project → Project Settings → Plugins 里启用 Funplay MCP for Godot，右侧会出现 Funplay MCP dock。

MCP server 默认在 http://127.0.0.1:8765/ 启动，端口被占用时自动挑另一个空闲本地端口，并把它存进 user://funplay_mcp_settings.cfg。dock 里能看到已装版本号，并提供 Check Updates 动作。

跟 Cocos 版一样，这是一个纯编辑器 addon——不会给导出的游戏引入运行时组件。

execute_code 与 120 个工具

主执行工具是 execute_code：AI 客户端提交一段代码做编辑器 / 运行时编排，附带可选的对象式上下文辅助、日志、变更追踪元数据。当许多细粒度小工具会让工具列表变得嘈杂时，一个高灵活度执行工具更合适。

但 execute_code 之外，Funplay MCP for Godot 还注册了 120 个工具函数，覆盖范围相当广：

分类	代表工具
场景 / PackedScene	get_scene_tree、open_scene、instantiate_scene、create_packed_scene_from_node
节点	create_node、reparent_node、set_node_property、set_transform_2d/3d、set_node_script
节点反射	list_node_properties、list_node_signals、list_node_methods
脚本	create_script、patch_script、validate_script、get_script_errors
工程地图	map_project、find_usages
项目设置 / 输入 / 自动加载	set_project_setting、add_input_action、set_autoload
运行时桥 / 撤销	install_runtime_bridge、editor_undo、editor_redo
Play / 输入模拟	enter_play_mode、simulate_action、simulate_key_event、set_time_scale
UI / Control	create_control、create_button、set_control_layout、connect_node_signal
动画 / 相机 / 材质	create_animation_clip、set_camera_3d、create_material

跟前两版一致，工具暴露分 core / full 两档：core 暴露一个紧凑的高信号工具集减少工具列表噪声，full 暴露完整自动化面。dock 里的 Tool Exposure 面板还能在当前档位内单独关掉某些工具。

工具的 JSON 输出会镜像进 MCP 的 structuredContent，节点 / 资源摘要里带上会话级 instance_id——后续调用直接用 ID 引用，不用反复按名字解析。

语言感知：GDScript 与 .NET 项目

Godot 这一版有一个 Unity / Cocos 版没有的设计：脚本工具是语言感知的。

addon 本身用 GDScript 实现，但它导出的脚本工作流会根据检测到的项目语言切换：

GDScript 项目看到 GDScript 工作流，.NET 项目看到 C# / .NET 工作流，混合项目两者都暴露。.NET 项目还会额外暴露 get_dotnet_project_info 之类的资源。脚本相关工具的有效集合，由检测到的项目语言和 dock 的 Tool Exposure 设置共同过滤。

Runtime Bridge：让 AI 验证运行时

编辑器自动化容易，运行时验证难——游戏跑起来之后，AI 怎么知道它的改动真的生效了？

Funplay MCP for Godot 的答案是 Runtime Bridge：一个可选安装的轻量 autoload，在 play 模式下写出心跳状态，供 AI 驱动的运行时验证读取。配合 enter_play_mode、simulate_action / simulate_key_event / simulate_mouse_button 等输入模拟工具，以及 capture_editor_view 截图，AI 可以在同一个 MCP 会话里完成"进入 play 模式 → 模拟输入 → 检查日志 → 截图验证"的闭环。

诊断侧还有一组断言工具：assert_node_exists、assert_node_property、assert_signal_connected，让 AI 把运行时验证写成显式断言，而不是靠截图肉眼判断。

Project Skills 与一键配置

连接 AI 客户端用 dock 里的 One-Click MCP Configuration：选目标客户端，点 Configure，addon 把推荐的 MCP 配置项写进去。支持 Codex、Claude Code、Cursor、VS Code。

更进一步的是 Configure + Skills——除了写配置，还会在 res://.funplay/skills/ 下生成项目本地的 skill 文件，以及一个给"读仓库指令"的 AI 客户端用的 AGENTS.md 桥接文件。这些 skill 文件捕获当前端点、工具档位、项目上下文和推荐的 Funplay 工作流，让 AI 客户端开箱就知道该怎么用这个 server。

手动配置的话，HTTP 形式：

{
  "mcpServers": {
    "funplay": {
      "type": "http",
      "url": "http://127.0.0.1:8765/"
    }
  }
}

仓库还在 stdio-wrapper/ 下提供了 npm 形式的 stdio 包装器，给那些不能直连 HTTP MCP 的客户端或注册表使用，并由 server.json 描述以便发布到 MCP Registry。

与 Unity / Cocos 版本的关系

Funplay MCP 系列三个引擎版本共用设计原则，差异来自引擎编辑器环境：

维度	Funplay MCP for Godot	Funplay MCP for Unity	Funplay MCP for Cocos
编辑器集成	Godot 编辑器 addon	Unity Editor 包	Cocos Creator 扩展
主执行工具	execute_code（GDScript）	execute_code（C#）	execute_javascript（JS）
工具总数	120	79	89
默认 / 完整档位	core / full	core / full	core / full / custom
语言感知	GDScript / .NET / 混合	C#	scene / editor 上下文
运行时验证	Runtime Bridge autoload + 断言	PlayMode 工具 + 截图	运行时控制 + 截图

三个版本的心智模型一致：默认 core 收敛工具面，execute_code / execute_javascript 作为主线，输入模拟 + 截图做视觉校验，需要时切 full。

写在最后

Godot 这一版除了沿用系列的设计取向，还针对 Godot 生态做了两件事：脚本工具按 GDScript / .NET 语言感知切换，以及用 Runtime Bridge 把"运行时验证"做成一等能力。对同时维护 GDScript 与 .NET 项目的团队，前者省去了大量"工具不匹配语言"的摩擦。

项目开源在 FunplayAI/funplay-godot-mcp，MIT 协议，支持 Godot 4.2+（含 .NET 项目）。如果它对你的 Godot 工作流有帮助，欢迎在 GitHub 上点个 Star。