Funplay Cocos MCP 是一个运行在 Cocos Creator 编辑器内部的 MCP 服务器扩展，允许 AI 编程助手通过 HTTP 端点直接操控项目、场景和资源。当前版本 0.1.1，内置 67 个工具，支持 Claude Code、Cursor、Trae、Kiro 等主流 AI 客户端一键接入。
项目全名 Funplay MCP for Cocos（npm 包名 funplay-cocos-mcp），MIT 许可，由 FunplayAI 维护，仓库位于 https://github.com/FunplayAI/funplay-cocos-mcp。67 个工具分布在 13 个分类中：脚本执行（3）、项目与场景（8）、节点编辑（3）、资产与预制件（8）、组件（6）、UI（4）、相机（3）、动画（4）、文件（8）、诊断（2）、运行时（4）、交互/输入（8）、截图与窗口（6）。另有 4 个内置提示（fix_script_errors、create_playable_prototype、scene_validation、auto_wire_scene）和 8 个内置 MCP 资源。工具总量虽然丰富，但默认的 core 配置只暴露 19 个高信号工具，避免 AI 客户端的工具列表过长。核心工具 execute_javascript 是整个扩展的关键入口，提供两种上下文模式：
// 在场景/运行时上下文中执行脚本
{
"tool": "execute_javascript",
"context": "scene",
"script": "console.log(cc.director.getScene().name);"
}
// 在编辑器 Node.js 上下文中执行脚本
{
"tool": "execute_javascript",
"context": "editor",
"script": "const fs = require('fs'); console.log(fs.readdirSync('.'));"
}
在 editor 上下文中，脚本会自动注入 Editor、fs、path、os、require 等全局对象，以及 getStatus()、listTools()、readResource(uri)、callTool(name, args)、configureClient(targetId) 等辅助函数。一个通用执行工具替代了大量功能狭窄的专用工具，这也是 core 配置只需 19 个工具的原因之一。
安装分两种方式。项目级安装：将 funplay-cocos-mcp/ 目录放入项目的 extensions/ 文件夹，在 Cocos Creator 中打开 Extension → Extension Manager → Refresh。全局安装：将扩展放到 ~/.CocosCreator/extensions/ 目录。安装完成后编辑器内会出现 MCP Server 面板，点击 Start Server 启动 HTTP 端点。面板提供一键配置功能，自动写入 Claude Code、Claude Desktop、Cursor、VS Code（Copilot / MCP 扩展）、Codex CLI、Trae、Kiro 的配置文件，其中 Trae 和 Kiro 的一键支持是 Cocos 版独有的，其他 Funplay MCP 系列不包含。
几个需要注意的点。首先，Funplay Cocos MCP 是纯编辑器扩展，最终构建产物中不会引入任何运行时依赖。其次，硬性要求 Cocos Creator 3.8 或更高版本，更低版本无法使用。再次，execute_javascript 在 editor 上下文中拥有完整的文件系统和 Node.js 访问权限，多人协作项目需注意权限风险。与同系列相比，Funplay Cocos MCP 共 67 个工具，Funplay Unity MCP 共 79 个工具，Funplay Godot MCP 共 105 个工具，Cocos 版目前工具数最少，覆盖范围足够日常编辑器操作，但生态成熟度还在早期阶段（版本号 0.1.1 说明这一点）。
如果你正在用 Cocos Creator 3.8+ 开发游戏并希望 AI 工具直接介入编辑器工作流，前往 GitHub 仓库 获取源码和文档。更多 AI 游戏开发实践内容见 GameBooom 博客；使用其他引擎的开发者可以查看 Funplay Unity MCP 等同系列仓库。