Funplay Godot MCP（全名 Funplay MCP for Godot）是一个运行在 Godot 编辑器内部的 MCP 服务器插件，通过本地 HTTP 端口向外部 AI 客户端暴露 105 个注册工具。它完全用 GDScript 编写，兼容 Godot 4.2 及以上版本，是 Funplay MCP 四仓库家族中工具数量最多的旗舰产品。
项目概况
当前最新版本为 0.4.0（发布于 2026-04-17），采用 MIT 许可证开源，仓库地址为 github.com/FunplayAI/funplay-godot-mcp。插件注册了 105 个工具，覆盖编辑器与运行时 API 的各类操作。安装后默认启用 core 配置文件——一个精简的高信号子集；如果需要全部能力，在 Funplay MCP 停靠面板中将配置文件切换为 full 即可。
该插件具有语言感知能力。底层虽然用 GDScript 实现，但在纯 GDScript 项目中只展示 GDScript 相关工具；在 Godot .NET（C#）项目中，额外的工具（如 get_dotnet_project_info）会自动出现；混合项目则同时展示两套工具。这意味着无论你的 Godot 项目采用哪种技术栈，插件都能适配。
另一个关键特征：它是 Editor-only 附加组件。导出的游戏中不会包含任何运行时组件，对产物零侵入。支持的 AI 客户端包括 Claude Code、Claude Desktop、Cursor、VS Code 和 Codex，均支持一键配置。
安装与连接
安装方式有两种。第一种，将仓库直接克隆为 Godot 项目并打开：
git clone https://github.com/FunplayAI/funplay-godot-mcp.git
# 在 Godot 4.2+ 中打开克隆下来的项目目录
第二种，将 addons/funplay_mcp/ 目录复制到现有项目的 res://addons/ 下，然后在项目设置中启用插件。
插件启用后，MCP 服务器默认监听 http://127.0.0.1:8765/。如果该端口被占用，插件会自动选择一个空闲的本地端口并保存配置，停靠面板中实时显示当前端点地址。
在 AI 客户端侧，以 Claude Desktop 为例，配置文件需要指向本地端点：
{
"mcpServers": {
"funplay-godot": {
"url": "http://127.0.0.1:8765/",
"transport": "http"
}
}
}
配置完成后，整个调用链路为：外部 AI 客户端发送 HTTP 请求 → Funplay MCP 插件（在 Godot 编辑器内）接收 → GDScript MCP 服务器分发至工具调度器 → 调用编辑器或运行时 API 执行具体操作。
注意事项
插件没有逐工具审批 UI——所有暴露的 MCP 工具在收到请求后直接执行，安全边界依赖于本地运行环境和开发者对 AI 客户端的控制。如果对 AI 自主操作编辑器有顾虑，建议先在独立测试项目中验证行为。
默认的 core 配置文件只包含精简工具集。如果发现 AI 客户端中缺少某些工具，需要手动在停靠面板中切换到 full 配置文件才能解锁全部 105 个工具。
此外，该插件仅在编辑器中运行，无法用于导出后的游戏运行时。如果工作流需要在运行时与 AI 交互，需要另寻方案。
开始使用
Funplay Godot MCP 的源码和维护文档位于 GitHub 仓库。它是 Funplay MCP 家族的一部分——如果你同时使用 Unity 或 Cocos Creator，可以关注同家族的 Funplay Unity MCP 等仓库。更多游戏 AI 工具链的实践内容，可参阅 gamebooom.ai 博客。