Funplay Cocos MCP 是一款专为 Cocos Creator 设计的纯编辑器扩展。通过将扩展文件放入项目目录并在编辑器内刷新，即可启动本地服务与 AI 客户端对接。
Funplay MCP for Cocos（包名 funplay-cocos-mcp）的当前版本为 0.1.1，核心功能由 execute_javascript 及其别名驱动。该扩展共收录了 67 个验证可用的工具，覆盖脚本执行、项目与场景、节点编辑、资产与预制体、组件、UI、相机、动画、文件、诊断、运行时以及交互输入等十余个类别。作为一款仅限编辑器环境的扩展，它在最终构建发布的游戏包体中不包含任何运行时依赖。这种设计既保证了开发阶段强大的脚本控制力，又避免了上线包体的冗余。同时，它内置了 fix_script_errors 和 create_playable_prototype 等 4 个实用提示词，能够直接提升解决工程问题的效率。
要在 Cocos Creator 3.8 项目中成功部署该扩展，需确保编辑器版本符合 3.8 及以上的硬性要求。安装分为本地项目和全局加载两种方式。推荐采用项目级本地安装：首先，将 funplay-cocos-mcp/ 文件夹直接克隆并放置在你的 Cocos 项目根目录下的 extensions/ 文件夹内；随后，打开 Cocos Creator 编辑器，在顶部菜单栏依次选择 Extension → Extension Manager → Refresh。如果你希望在所有项目中通用，也可以将其作为全局扩展加载，只需将文件夹放置于 ~/.CocosCreator/extensions/ 目录下即可。
安装完毕并刷新后，编辑器界面内会出现一个 MCP Server 面板。点击面板上的 Start Server 按钮，系统就会在本地启动 HTTP 端点。接下来需要配置你的 AI 编程助手。该扩展兼容 Claude Code、Claude Desktop、Cursor、VS Code (Copilot / MCP extension)、Codex CLI、Trae 以及 Kiro。在 MCP Server 面板中提供了一键配置功能，可直接写入对应客户端的配置文件。如果需要手动配置，以 Claude Code 或 Claude Desktop 为例，你可以直接将以下 JSON 配置复制到相应的设置文件中：
{
"mcpServers": {
"funplay-cocos": {
"type": "http",
"url": "http://127.0.0.1:8765/"
}
}
}
如果你使用的是 Codex CLI，则需要在 TOML 配置文件中写入对应的地址：
[mcp_servers.funplay-cocos]
url = "http://127.0.0.1:8765/"
在实际使用中有几项技术细节需要注意。首先，该扩展的作用域仅限于 Cocos Creator 编辑器，无法在运行时环境或真机调试中生效；如果你需要针对运行时 Profiler 或设备特性的调试，应当依赖引擎自身的工具链。其次，该扩展高度依赖 Cocos Creator 3.8 及以上的接口，切勿在低于此版本的编辑器中强行安装，以免出现 API 不兼容导致的崩溃。最后，该工具的核心机制是执行 JavaScript 脚本，如果你的团队规范对编辑器