Cocos MCP 下载与安装教程：Funplay MCP for Cocos 让 AI 直接操作 Cocos Creator

1. 为什么 Cocos Creator 开发者需要 MCP从手动改脚本到 AI 直接操作场景如果你用 Cocos Creator 做过 UI 或者原型大概率经历过这种循环在编辑器里拖一个 Canvas加 Label、Button、Sprite调锚点和坐标切回脚本写逻辑再切回编辑器看效果。一个登录页来回切十几次时间全花在重复劳动上。Cocos MCP 要解决的就是这件事——让 AI 编程助手通过 MCPModel Context Protocol直接连上 Cocos Creator 编辑器读取当前场景、节点层级、组件属性并且能执行操作。Funplay MCP for Cocos 是一个嵌入 Cocos Creator 编辑器的 MCP Server 扩展。它的架构和需要额外跑独立进程的方案不同HTTP MCP Server 直接内嵌在扩展里不需要单独启动 Python 守护进程或外部 Bridge。AI 客户端Claude Code、Cursor、Codex、VS Code Copilot、Trae、Kiro 等连上本地地址后就能调用工具去检查项目信息、操作节点、创建 UI、截图验证。它面向 Cocos Creator 3.8属于 Editor Only 扩展不会往最终游戏包里塞运行时依赖。这一点对上线项目很关键——你不用担心打包体积被撑大。适合谁用三类人最直接一是经常做 UI 和场景搭建的 Cocos Creator 开发者想让 AI 帮忙批量创建节点二是用 AI 编程助手写 TypeScript 逻辑但希望 AI 能同时看到编辑器状态的三是做游戏原型需要快速验证交互和视觉效果的独立开发者。我试过让 AI 在当前场景里创建一个带账号输入框、密码输入框、登录按钮和游客登录按钮的登录页它调用execute_javascript配合场景和 UI 工具完成了节点创建最后截图确认布局。整个过程不需要我手动拖一个控件。下面把从下载安装到验证的完整流程拆开讲。2. TaoToken 前置准备统一 Key 与 API 通道接入说明在配置 MCP 客户端之前先把模型调用通道准备好。Funplay MCP for Cocos 负责的是「AI 操作 Cocos Creator」这一层而 AI 客户端本身要能调用大模型。如果你用 Claude Code、Codex 这类工具需要配置可用的 API 通道。TaoToken 提供统一的 Key 和 API 入口把模型调用集中管理省去在多个客户端里分别填不同厂商配置的麻烦。TaoToken 官网地址https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 入口https://taotoken.net/api先注册并创建一个 API Key。拿到 Key 之后不同客户端的接入方式略有差异但核心三件套是一致的Base URL、API Key、Model ID。下面按客户端分别说明。对于 Claude Code配置通常写在 settings 文件里Base URL 指向 TaoToken 的 API 地址Key 填你创建的令牌Model ID 选你需要的模型。对于 Codex配置写在auth.json或对应的 MCP/模型配置中。对于 Cursor则在设置里的模型提供方处填写 Base URL 和 Key。这里要强调一点TaoToken 是模型调用的统一通道不是 Cocos MCP 的替代品。Funplay MCP for Cocos 负责编辑器操作TaoToken 负责模型请求两者配合才能跑通「AI 理解你的指令 → 调用模型 → 通过 MCP 操作 Cocos」的闭环。如果你还没决定用哪个客户端建议先从 Claude Code 或 Cursor 入手它们的 MCP 配置比较直观。拿到 Key 后先别急着配 MCP先确认模型通道能正常返回再往下走。这样出问题时能快速定位是模型通道的问题还是 MCP 连接的问题。3. 可复制配置Funplay MCP for Cocos 安装与客户端接入这一节给出可以直接复制的配置片段。先装扩展再配客户端。3.1 安装 Funplay MCP for Cocos 扩展方式一从 Cocos Store 安装。打开 Cocos Creator进入扩展商店搜索 Funplay MCP安装后重启编辑器。方式二手动放入项目。在你的 Cocos Creator 项目根目录创建extensions目录把解压后的funplay-cocos-mcp放进去最终结构如下MyGame ├─ assets ├─ extensions │ └─ funplay-cocos-mcp ├─ settings ├─ library └─ project.json方式三Git 克隆。在项目根目录执行cd /path/to/your-cocos-project mkdir -p extensions git clone https://github.com/FunplayAI/funplay-cocos-mcp.git extensions/funplay-cocos-mcp安装完成后重启 Cocos Creator或在扩展管理里重新加载。3.2 启动 MCP Server在 Cocos Creator 顶部菜单找到Funplay MCP Server打开面板。默认服务地址是http://127.0.0.1:8765/启动后AI 客户端连接这个本地地址即可。3.3 客户端配置片段Codex 配置TOML 格式[mcp_servers.funplay_cocos] url http://127.0.0.1:8765/Cursor 配置JSON 格式{ mcpServers: { funplay_cocos: { url: http://127.0.0.1:8765/ } } }Claude Code / Claude Desktop 配置{ mcpServers: { funplay_cocos: { type: http, url: http://127.0.0.1:8765/ } } }VS Code 配置{ servers: { funplay_cocos: { type: http, url: http://127.0.0.1:8765/ } } }服务器名称统一用funplay_cocos不要改否则部分客户端识别不到。3.4 可选配置文件如果需要在项目级别自定义 MCP 行为在 Cocos 项目根目录创建funplay-cocos-mcp.config.json{ host: 127.0.0.1, port: 8765, toolProfile: core, enabledToolCategories: [], disabledToolCategories: [], enabledTools: [], disabledTools: [], enableSessions: false, executeJavascriptSafetyChecks: true, autostart: true, maxInteractionLogEntries: 50, activeToolProfileName: , savedToolProfiles: [] }也支持环境变量COCOS_MCP_HOST、COCOS_MCP_PORT、COCOS_MCP_PROFILE。注意默认toolProfile是core只开放 39 个高频工具。需要全部 105 个工具时改成full。普通项目建议先用core减少 AI 的工具列表噪音。4. 验证请求与成功结果确认 AI 真的能操作 Cocos Creator配置写完不代表通了必须验证。分两步先用命令行确认 MCP Server 活着再让 AI 客户端实际调用工具。4.1 用 curl 检查本地服务Funplay MCP for Cocos 提供两个只读接口方便在不连 AI 客户端的情况下检查服务状态curl http://127.0.0.1:8765/health curl http://127.0.0.1:8765/tools/health正常返回说明 Cocos Creator 内部的 MCP Server 已经启动。/tools会列出当前 profile 下可用的工具清单。如果/health返回连接拒绝先回到 Cocos Creator 确认Funplay MCP Server面板是否处于启动状态。4.2 让 AI 执行查询类工具在 AI 客户端里输入调用 get_project_info告诉我当前 Cocos 项目信息。或者读取资源上下文读取 cocos://project/context告诉我当前 Cocos Creator 编辑器状态。再测试execute_javascript的两个上下文使用 execute_javascript 的 scene 上下文返回当前场景名称。 使用 execute_javascript 的 editor 上下文返回当前项目路径。这些测试正常返回说明 MCP Server 已经和 AI 客户端连上了。4.3 实际创建一个 UI 节点验证连接之后做一次真实操作。在 AI 客户端输入在当前 Cocos 场景里创建一个登录页面。 要求 1. 创建 Canvas 2. 添加背景 3. 添加账号输入框 4. 添加密码输入框 5. 添加登录按钮 6. 添加游客登录按钮 7. 检查节点层级 8. 截图验证最终效果AI 会调用execute_javascript以及场景、节点、UI、截图相关工具。完成后你可以在 Cocos Creator 的层级管理器里看到新建的节点在场景编辑器里看到布局。截图工具会返回当前场景或编辑器的画面用来确认按钮位置和整体效果。如果这一步成功最小闭环就跑通了AI 理解指令 → 调用模型 → 通过 MCP 操作 Cocos Creator → 截图回传验证。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth配置过程中最容易卡在几个报错上逐个说。401 Unauthorized。这个通常不是 MCP 的问题而是模型通道的 Key 不对或过期。检查 TaoToken 的 API Key 是否复制完整Base URL 是否填对。如果你在 Claude Code 里看到 401先确认 settings 里的 Key 和 Base URL 匹配。注意 Key 不要有多余空格。local proxy failed / connection refused。MCP 客户端连不上http://127.0.0.1:8765/。先执行curl http://127.0.0.1:8765/health确认服务是否启动。如果端口被占用Funplay MCP 会检查已有 listener 是否属于同一个 Cocos 项目不是的话会自动切换到其他可用本地端口。这时你要回到Funplay MCP Server面板看实际端口同步更新客户端配置里的 URL。reading choices / 工具列表为空。AI 客户端连上了但看不到工具多半是 profile 问题。默认core模式只开放 39 个工具如果你要找的工具不在里面把toolProfile改成full。另外确认客户端配置里的服务器名称是funplay_cocos名称写错会导致工具注册失败。OAuth 相关报错。部分客户端在连接 HTTP MCP 时会尝试 OAuth 流程但 Funplay MCP 是本地 HTTP 服务不需要 OAuth。检查配置里是否有多余的 auth 字段去掉即可。如果客户端强制走 OAuth换用支持纯 HTTP MCP 的客户端版本。Codex auth.json 配置问题。Codex 的模型通道和 MCP 配置是分开的。auth.json管模型调用MCP 配置管funplay_cocos连接。两者都要对Base URL Key Model ID 三件套填在模型配置里[mcp_servers.funplay_cocos]填在 MCP 配置里。混在一起会导致连接异常。修改端口后没生效。在 MCP Settings 里改端口会自动保存配置需要时自动重启服务。如果没生效手动重启 Cocos Creator 再试。多个 Cocos Creator 版本冲突。全局扩展按 Creator 版本隔离。如果你同时用 3.8.5 和 3.8.8需要在每个版本里分别执行一次「为所有项目安装」。否则只有一个版本能加载扩展。6. 语义一致 CTA把模型通道和 MCP 接入一次配好跑通最小闭环之后建议把模型通道和 MCP 配置固化下来避免每次换项目重新折腾。模型调用统一走 TaoTokenKey 和 Base URL 配一次Claude Code、Codex、Cursor 都能复用。API Key 管理入口在控制台接入文档里有各客户端的详细配置说明。如果你主要做长期编码和 Agent 类任务Coding Plan 更适合持续调用场景。API Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi_keys接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc模型对话验证https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentchatCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding_planFunplay MCP for Cocos 这边扩展装好后把funplay-cocos-mcp.config.json放进项目根目录toolProfile按需在core和full之间切换。日常开发用core减少噪音需要批量操作 Prefab 或做完整场景自动化时切full。最后给一个实用建议把execute_javascript当作主工具配合场景检查、资产检查、脚本诊断和截图。AI 改完 UI 后让它截图确认比你自己切回编辑器看要快。如果按钮位置不对直接让 AI 根据截图调整形成「操作 → 截图 → 修正」的循环。这套流程跑顺之后Cocos Creator 里的重复搭建工作能省下不少时间。