Funplay Godot MCP 提供了 Core 和 Full 两种工具配置方案,前者提供精简的高信噪比工具子集,后者包含全部 105 个已注册工具。开发者可根据 AI 客户端的上下文窗口大小和实际开发需求,在两者之间进行切换。
Funplay Godot MCP 是一个完全基于 GDScript 编写的 Godot 编辑器插件,它作为 MCP 服务器,将引擎的编辑器与运行时 API 直接暴露给外部 AI 客户端。该项目在 0.4.0 版本中通过增加底层工具,将注册工具总数扩展至 105 个。该插件支持 Godot 4.2 及以上版本,并且完全兼容 Godot .NET (C#) 项目。它具备语言感知能力:纯 GDScript 项目只能看到 GDScript 工具,.NET 项目会看到如 get_dotnet_project_info 等 C#/.NET 工具,而混合项目则同时显示两类工具。
Core 与 Full 配置的核心差异在于工具暴露的范围与 AI 感知噪声的平衡。Full 配置直接暴露全部 105 个工具,提供最全面的底层控制能力。而 Core 配置遵循 execute_code first 原则,强调通过单一的、高灵活性的 GDScript 执行工具来处理大部分编辑器和运行时编排任务。这种设计避免了为每个编辑器操作创建狭窄专用工具的需求,从而大幅减少 MCP 工具列表的长度,降低了 AI 客户端的工具选择噪声。
要集成该插件,可以直接克隆仓库作为 Godot 项目打开,或者将 addons/funplay_mcp/ 目录拷贝至现有项目的 res://addons/ 目录中。进入 Godot 编辑器后,打开 Project -> Project Settings -> Plugins 并启用 Funplay MCP for Godot。启用后,编辑器右侧会出现 Funplay MCP 停靠面板。MCP 服务器启动后,默认监听地址为 http://127.0.0.1:8765/。
在底层架构上,外部 AI 客户端发送 HTTP 请求到 Godot 编辑器内的插件,GDScript MCP 服务器接收请求后,经由工具调度器分发给 105 个注册工具,最终调用对应的编辑器或运行时 API。
对于 AI 客户端的支持,插件允许通过面板一键配置 Claude Code、Claude Desktop、Cursor、VS Code 和 Codex。若需手动配置,可参考以下格式。Claude Code 或 Claude Desktop 的配置格式如下:
{
"mcpServers": {
"funplay": {
"type": "http",
"url": "http://127.0.0.1:8765/"
}
}
}
Codex CLI 使用 TOML 格式:
[mcp_servers.funplay]
url = "http://127.0.0.1:8765/"
在选择配置时应注意 AI 模型的工具处理能力。如果 AI 客户端的上下文窗口有限,或在包含大量工具时容易出现选择错误,不建议使用 Full 配置暴露全部 105 个工具,此时应使用默认的 Core 配置。此外,该插件强依赖于 Godot 编辑器的运行环境,无法在无图形界面的纯 CI/CD 构建流水线中作为独立后台服务运行。
请访问 Funplay Godot MCP 主仓库 获取源码。更多游戏开发与 AI 集成的技术文章可以在 Gamebooom 博客 找到。如果你同时负责多引擎项目,也可以尝试同系列的 Funplay Unity MCP(共 79 个工具)或 Funplay Cocos MCP(共 67 个工具)。
meta_title: Funplay Godot MCP Core与Full工具配置对比:105个工具 meta_description: 深度解析Funplay Godot MCP的Core与Full工具配置差异,涵盖105个注册工具、架构原理、一键配置方法及语言感知特性。 primary_keywords: Godot MCP, Funplay MCP, AI辅助开发, GDScript, MCP Server