Cocos Store商店本插件产品链接,限时优惠中:
https://store.cocos.com/app/detail/10014
Cocos MCP AI Master 插件,是一款可以安装在 Cocos Creator 3.8.8 编辑器里的扩展插件,把 Cocos 实战知识和编辑器操作封装成标准 MCP 工具,供 AI 编程 Agent 直接调用。形象地说,Cocos MCP AI Master 插件相当于给 AI 编程 Agent 配上一颗懂 Cocos Creator 3.8.8 编辑器的「小脑」和一双能操作编辑器的「双手」,让场景、界面、动画在游戏项目里一步步搭建完成,直到构建发布与试玩都跑通。
通用 AI 编程 Agent 会写代码,但面对 Cocos 的版本差异、参数写法和编辑器操作,不能只靠通用经验猜。插件补齐 Cocos 知识与操作能力,减少反复试错和返工,也节省因此多花的 AI 大模型Token费用。
如果你刚接触 Cocos,不必先把编辑器用法全部学一遍,就能把想法做成能打开、能试玩的项目;如果你已有开发经验,可以把场景搭建、属性配置、结果检查等重复工作交给 AI,把时间留给玩法和内容。
-
实战教学视频:https://www.bilibili.com/video/BV1zhWi6cEKW/
-
安装教学视频:https://www.bilibili.com/video/BV1yBsE6xEGX/
功能介绍
解决的痛点
把想法做成能玩的游戏,难在整条链哪一环都不能掉链子。 从场景、界面、动画、脚本到试玩和构建发布,任何一环要人反复接手,AI 的效率就会打折。常见卡点有四类:
① 起步段 ·「懂」:正确写法不在手边。 AI 大模型不熟悉当前版本的设置、取值和常见坑,容易靠猜;结构搭歪了,后面还要返工。
② 实现段 ·「做」:答案停在对话里。 代码和方案有了,场景、组件和属性还得人手动搬进项目;说得对,不等于项目里已经改好了。
③ 验证段 ·「信」:说成功不等于做成了。 编辑器里有没有真的改对,仍要逐面板检查;结果不清楚,就不敢继续往下做。
④ 交付与迭代段 ·「续」:长任务怕中断。 连续修改时遇到确认框,人不在就会停住;换 AI 编程 Agent 或重开对话,也要重新配置接入。
主要功能点
Cocos MCP AI Master 插件这样解决这些卡点: 你只需描述目标,不用先记工具名。
-
「懂」|Cocos 实战知识库,先查再做:开发中常用的设置、取值约束、常见坑与不推荐写法都能查到,减少靠猜和反复试错,也不必把编辑器用法逐条教给 AI 大模型。 -
「做」|标准 MCP 工具,通过编辑器操作修改游戏项目:修改经由封装好的编辑器操作完成,不直接改项目文件、不靠人复制粘贴;场景与资源文件由 Cocos Creator 编辑器全程维护,避免私有格式被破坏。从场景、界面、动画、资源、脚本到构建试玩,2D 界面和 3D 场景共用同一套工具链。 -
「信」|改完能核对,差在哪一项说清楚:可核对节点结构、组件属性、界面布局、运行画面和构建结果,对不上就报出差异。参数校验不通过会明确报错;节点、组件等编辑类改动改坏了能在编辑器里撤回,是否继续由你决定。 -
「续」|连续修改不用步步守着:长任务可以连续推进,减少中途停下来等你点确认的情况;换 AI 编程 Agent 或重开对话,点面板「自动配置」即可接好,不用手改配置文件。
从搭建到试玩,具体能做什么
每一类都能核对完成结果,不只看一句「成功」。
| 这类活 | 它替你做什么 | 完成时怎么核对 |
|---|---|---|
搭场景 |
创建节点、组织层级、配置相机与光照 | 核对节点结构,空名称、层级过深等问题会列出来 |
做界面 |
创建按钮、文本、列表和弹窗,处理对齐、锚点与多分辨率适配 | 检查零尺寸、对齐冲突,核对背景铺满、黑边与控件出界 |
配脚本与交互 |
创建和编辑 TypeScript 脚本,挂载组件并绑定脚本属性 | 查询编译状态,失败时给出文件、行号与错误信息 |
接动效 |
编辑动画剪辑、关键帧、曲线和帧事件,也可处理 Spine 骨骼动画 | 核对动画剪辑与播放状态 |
管资源与预制体 |
创建和导入资源、生成预制体、查询资源引用与依赖 | 检查缺失或失效的资源引用 |
构建与试玩 |
按平台构建发布,打开预览,执行点击等交互试玩并截图 | 核对构建结果、运行时动作和玩家视角画面;失败给出原因 |
能调动多少动作
20+ 个 MCP 工具,200 个以上可调用动作。
动作数按用途列成五组:前四组对应「懂 / 做 / 信 / 续」(「做」按修改对象分三行),第五组「管」负责项目与接入。
| 能力层 | 具体能力(动作数) | 这些动作解决什么 |
|---|---|---|
懂|先查再做 |
知识库 9 | 动手前先查清正确写法、取值范围和常见坑,不靠一轮轮试错去猜 |
做|场景·节点·组件 |
场景 15、节点 16、组件 8、物理 6 | 搭场景、组织节点、挂组件与配物理,都通过编辑器操作完成 |
做|界面·预制体·动画 |
界面 11、预制体 10、动画 43、2D 对象 9 | 做界面、生成预制体、编辑动画关键帧,2D 与 3D 共用一套工具 |
做|资源·脚本·渲染 |
资源 17、渲染 8、材质 3、脚本 9、视图 20、批量 4 | 资源引用、脚本、渲染材质、视图与批量操作,同一套工具完成 |
信|改完能核对 |
诊断 12、试玩 5、引擎 1 | 核对最终结果、找出问题原因、玩家视角截图与画面校验,错在哪一步看得见 |
续|长任务连续推进 |
构建 10、预览 3 | 构建前检查、构建与预览连续进行,减少中途人工接手 |
管|项目与接入 |
项目 4、编辑器 17、服务 1 | 项目配置、编辑器状态与服务地址查询 |
表中为当前版本的动作数,具体以你安装的版本为准。
跨电脑开发 AI 编程 Agent 与 Cocos Creator 编辑器不在同一台电脑时,不用把游戏项目搬过去:
| 方式 | 地址与用法 |
|---|---|
| 方式 1 · 本机 | AI 编程 Agent 与编辑器同机,用 http://127.0.0.1:3600/mcp,最常用 |
| 方式 2 · 局域网 | 同网段时填面板给出的局域网地址(形如 http://<编辑器电脑 IP>:3600/mcp),支持多个 AI 编程 Agent 同时接入 |
| 方式 3 · 远程 | 跨网段时,使用你自行配置的隧道地址;插件不提供隧道服务 |
运行环境与接入方式
| 项目 | 说明 |
|---|---|
| 协议 | MCP(Model Context Protocol),兼容 2024-11-05 / 2025-03-26 / 2025-11-25 三个协议版本,连接时自动协商 |
| 接入端点 | http://127.0.0.1:3600/mcp,端口被占用时自动调整,以面板提示为准 |
| AI 编程 Agent | WorkBuddy、Trae CN、Qoder、Cursor、VS Code、Codex CLI、Windsurf、Kiro、Devin、Claude CLI、Gemini CLI 均可接入;不绑定特定 AI 大模型,游戏项目原地使用,无需迁移 |
| 编辑器 | Cocos Creator 3.8.8 编辑器;其他 3.x 游戏项目升级到 3.8.8 并能正常打开后即可接入 |
| 操作系统 | Windows x64、macOS(Intel 与 Apple 芯片) |
| 运行环境 | 使用 Cocos Creator 编辑器内置的 Node.js 运行时,无需单独安装 Node.js |
| 网络范围 | 本机、局域网或自行配置的隧道,只接受这三类连接 |
| 依赖 | 不提供 AI 大模型 API,AI 大模型由你自行通过正规渠道获取和配置 |
版本发布前的质量验证
每次版本发布前都会做两类验证:3000+ 条测试用例全部重跑;从 0 开始把游戏开发、构建发布、试玩的真实业务流程完整走通。
适配你的项目吗
适合你,如果:
- 正在使用 Cocos Creator 3.8.8 编辑器,或能把现有游戏项目升级到 3.8.8 并正常打开
- 从空项目做原型,或在现有游戏项目中搭建场景、制作界面、编辑脚本与动画
- 希望 AI 通过编辑器操作修改游戏项目,并能核对结果、构建发布和试玩
- 编辑器与 AI 编程 Agent 不在同一台电脑,或需要多个 AI 编程 Agent 同时接入
这类期待它不承接:
- 希望给一条需求就自动生成可直接发行的完整游戏
- 希望插件自带 AI 大模型,或代替你判断结果对错
安装失败、连不通时怎么办
| 现象 | 处理 |
|---|---|
| 安装后在「扩展」菜单里找不到插件 | 确认导入的是插件压缩包本身(不是解压出来的子目录),并在「已安装扩展」页签确认开关已开启;手动解压放置的方式才需要重启编辑器 |
| 换了 AI 编程 Agent 就连不上 | 用面板「自动配置」按提示重新完成当前 AI 编程 Agent 的接入配置,再重启该 AI 编程 Agent;仍不通可联系客服协助 |
| 预览一片空白,或构建出来画面比例不对 | 跑一次诊断或构建前比例预检找出原因,按提示给出的修复方向处理 |
安装注意事项
- 插件是项目级扩展:安装在当前打开的 Cocos 项目里,每个项目各装一次;
- 插件包为 .zip,导入时保持压缩包不变;导入不可用时才改为手动解压放置。
使用教程
用「」括起的文字表示界面上可直接点击的菜单、页签或按钮。
第 1 步 · 安装插件
Cocos Store商店本插件产品链接,限时优惠中:
https://store.cocos.com/app/detail/10014
从 Cocos Store「已购资源」下载插件包,保持 zip、先不要解压。 用 Cocos Creator 3.8.8 编辑器打开你要开发的项目,顶部菜单「扩展」→「扩展管理器」,点工具栏上的导入图标,选中插件包即可;切到「已安装扩展」页签,能看到插件且右侧开关为开启状态,即完成安装。
图 1 · 在「扩展管理器」点导入图标后,选中插件包,点「打开」。
图 2 · 「已安装扩展」页签里插件已加载,右侧开关为开启状态。
图 3 · 安装完成后,插件目录位于当前开发项目的 extensions 下。
第 2 步 · 打开 MCP Server 面板
「扩展」→「Cocos MCP AI Master」→「打开 MCP Server 面板」。面板显示服务地址与端口,运行状态可见。
图 4 · 「MCP Server」面板首页,服务地址与运行状态可见。
第 3 步 · 接入你的 AI 编程 Agent
点面板「自动配置」,按面板提示完成接入配置,重启该 AI 编程 Agent 后,即可在对话里调用编辑器能力。实际端口以插件面板提示为准:
{
"mcpServers": {
"cocos-mcp": {
"url": "http://127.0.0.1:3600/mcp"
}
}
}
图 5 · 「MCP 客户端配置」页提供服务地址与配置示例,并列出常见 AI 编程 Agent。
第 4 步 · 激活并验证
- 在编辑器里激活:「扩展」→「Cocos MCP AI Master」→ 打开 MCP Server 面板 → 点「激活插件」→ 粘贴激活码 → 点「激活」;面板右上角显示账号 / 类型 / 套餐 / 剩余四项即完成。
- 验证接通:在你的 AI 编程 Agent 里发一条简单指令(例如「列出当前场景的层级」),能拿到编辑器返回的结果即接通完成。
安装或激活过程中遇到问题,可通过下方「联系作者」联系客服协助处理。
图 6 · 在面板右上角完成激活:首次点「激活插件」,已激活后从「变更激活码」进入同一弹窗。
联系作者
-
客服微信:GameAIMaster(建议优先)

-
客服邮箱:aigameui@qq.com -
客服 QQ:3986416481 -
论坛 Store 专区用户反馈集中帖:Cocos MCP AI Master插件发布,把 Cocos 实战知识和编辑器操作封装成标准 MCP 工具,供 AI 编程 Agent 直接调用
欢迎反馈实际使用中的问题,每个反馈都会被认真对待。
更新声明
- 1.0.0
- Cocos MCP AI Master 首个正式版本:Cocos Creator 3.8.8 编辑器扩展插件(MCP Server 工具);
- 20+ 个 MCP 工具、200 个以上可调用动作,覆盖从场景搭建到构建试玩的主要环节;
- 内置 Cocos 实战知识库,包含常用设置、取值约束与常见坑;
- 支持结果核对、交互试玩、玩家视角截图,节点与组件等编辑类改动可在编辑器里撤销;
- 支持本机、局域网与自行配置的隧道接入,购买后凭激活码启用。
购买须知
Cocos Store商店本插件产品链接:
https://store.cocos.com/app/detail/10014
本产品为付费虚拟商品,一经购买成功概不退款,请支付前谨慎确认购买内容。
激活码获取:在 Cocos Store 下单付费后,联系客服即可获取激活码与售后服务支持(建议优先加客服微信 GameAIMaster)。
许可声明:插件包、源码与文档的著作权归作者所有;购买获得的是在你自己的项目中使用本插件的授权。未经作者书面许可,不得复制、转售、再分发插件包或源码,也不得将本插件代码或其衍生代码用于其他产品。
责任边界:
- 本插件是 Cocos Creator 3.8.8 编辑器的扩展插件,无法独立运行,请先安装该版本编辑器。本产品不提供 AI 大模型 API 服务,AI 大模型需由用户自行通过正规渠道获取与配置。
**
免责说明:**本产品按现状提供,AI 生成的内容可能存在偏差,用户应在使用中自行校验结果(包括但不限于节点结构、资源引用、构建产物)。文中提及的软件与 AI 编程 Agent 名称,仅用于说明兼容性,相关商标归各自所有者所有。
Cocos Store商店本插件产品链接,限时优惠中:
https://store.cocos.com/app/detail/10014

搭场景
做界面
配脚本与交互
接动效
管资源与预制体
构建与试玩
管|项目与接入




