Cocos MCP AI Master插件发布,把 Cocos 实战知识和编辑器操作封装成标准 MCP 工具,供 AI 编程 Agent 直接调用


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,把时间留给玩法和内容。

  1. :clapper: 实战教学视频:https://www.bilibili.com/video/BV1zhWi6cEKW/
  2. :inbox_tray: 安装教学视频:https://www.bilibili.com/video/BV1yBsE6xEGX/

:toolbox: 功能介绍

:dart: 解决的痛点

把想法做成能玩的游戏,难在整条链哪一环都不能掉链子。 从场景、界面、动画、脚本到试玩和构建发布,任何一环要人反复接手,AI 的效率就会打折。常见卡点有四类:

:brain: ① 起步段 ·「懂」:正确写法不在手边。 AI 大模型不熟悉当前版本的设置、取值和常见坑,容易靠猜;结构搭歪了,后面还要返工。

:hammer_and_wrench: ② 实现段 ·「做」:答案停在对话里。 代码和方案有了,场景、组件和属性还得人手动搬进项目;说得对,不等于项目里已经改好了。

:mag: ③ 验证段 ·「信」:说成功不等于做成了。 编辑器里有没有真的改对,仍要逐面板检查;结果不清楚,就不敢继续往下做。

:repeat: ④ 交付与迭代段 ·「续」:长任务怕中断。 连续修改时遇到确认框,人不在就会停住;换 AI 编程 Agent 或重开对话,也要重新配置接入。

:jigsaw: 主要功能点

Cocos MCP AI Master 插件这样解决这些卡点: 你只需描述目标,不用先记工具名。

  • :brain: 「懂」|Cocos 实战知识库,先查再做:开发中常用的设置、取值约束、常见坑与不推荐写法都能查到,减少靠猜和反复试错,也不必把编辑器用法逐条教给 AI 大模型。

  • :hammer_and_wrench: 「做」|标准 MCP 工具,通过编辑器操作修改游戏项目:修改经由封装好的编辑器操作完成,不直接改项目文件、不靠人复制粘贴;场景与资源文件由 Cocos Creator 编辑器全程维护,避免私有格式被破坏。从场景、界面、动画、资源、脚本到构建试玩,2D 界面和 3D 场景共用同一套工具链。

  • :mag: 「信」|改完能核对,差在哪一项说清楚:可核对节点结构、组件属性、界面布局、运行画面和构建结果,对不上就报出差异。参数校验不通过会明确报错;节点、组件等编辑类改动改坏了能在编辑器里撤回,是否继续由你决定。

  • :repeat: 「续」|连续修改不用步步守着:长任务可以连续推进,减少中途停下来等你点确认的情况;换 AI 编程 Agent 或重开对话,点面板「自动配置」即可接好,不用手改配置文件。

:hammer_and_wrench: 从搭建到试玩,具体能做什么

每一类都能核对完成结果,不只看一句「成功」。

这类活 它替你做什么 完成时怎么核对
:building_construction: 搭场景 创建节点、组织层级、配置相机与光照 核对节点结构,空名称、层级过深等问题会列出来
:art: 做界面 创建按钮、文本、列表和弹窗,处理对齐、锚点与多分辨率适配 检查零尺寸、对齐冲突,核对背景铺满、黑边与控件出界
:keyboard: 配脚本与交互 创建和编辑 TypeScript 脚本,挂载组件并绑定脚本属性 查询编译状态,失败时给出文件、行号与错误信息
:film_strip: 接动效 编辑动画剪辑、关键帧、曲线和帧事件,也可处理 Spine 骨骼动画 核对动画剪辑与播放状态
:package: 管资源与预制体 创建和导入资源、生成预制体、查询资源引用与依赖 检查缺失或失效的资源引用
:rocket: 构建与试玩 按平台构建发布,打开预览,执行点击等交互试玩并截图 核对构建结果、运行时动作和玩家视角画面;失败给出原因

:zap: 能调动多少动作

20+ 个 MCP 工具,200 个以上可调用动作。

动作数按用途列成五组:前四组对应「懂 / 做 / 信 / 续」(「做」按修改对象分三行),第五组「管」负责项目与接入。

能力层 具体能力(动作数) 这些动作解决什么
:brain: 懂|先查再做 知识库 9 动手前先查清正确写法、取值范围和常见坑,不靠一轮轮试错去猜
:hammer_and_wrench: 做|场景·节点·组件 场景 15、节点 16、组件 8、物理 6 搭场景、组织节点、挂组件与配物理,都通过编辑器操作完成
:hammer_and_wrench: 做|界面·预制体·动画 界面 11、预制体 10、动画 43、2D 对象 9 做界面、生成预制体、编辑动画关键帧,2D 与 3D 共用一套工具
:hammer_and_wrench: 做|资源·脚本·渲染 资源 17、渲染 8、材质 3、脚本 9、视图 20、批量 4 资源引用、脚本、渲染材质、视图与批量操作,同一套工具完成
:mag: 信|改完能核对 诊断 12、试玩 5、引擎 1 核对最终结果、找出问题原因、玩家视角截图与画面校验,错在哪一步看得见
:repeat: 续|长任务连续推进 构建 10、预览 3 构建前检查、构建与预览连续进行,减少中途人工接手
:card_index_dividers: 管|项目与接入 项目 4、编辑器 17、服务 1 项目配置、编辑器状态与服务地址查询

表中为当前版本的动作数,具体以你安装的版本为准。

:globe_with_meridians: 跨电脑开发 AI 编程 Agent 与 Cocos Creator 编辑器不在同一台电脑时,不用把游戏项目搬过去:

方式 地址与用法
方式 1 · 本机 AI 编程 Agent 与编辑器同机,用 http://127.0.0.1:3600/mcp,最常用
方式 2 · 局域网 同网段时填面板给出的局域网地址(形如 http://<编辑器电脑 IP>:3600/mcp),支持多个 AI 编程 Agent 同时接入
方式 3 · 远程 跨网段时,使用你自行配置的隧道地址;插件不提供隧道服务

:desktop_computer: 运行环境与接入方式

项目 说明
协议 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 大模型由你自行通过正规渠道获取和配置

:white_check_mark: 版本发布前的质量验证

每次版本发布前都会做两类验证:3000+ 条测试用例全部重跑;从 0 开始把游戏开发、构建发布、试玩的真实业务流程完整走通。

:thinking: 适配你的项目吗

:white_check_mark: 适合你,如果:

  • 正在使用 Cocos Creator 3.8.8 编辑器,或能把现有游戏项目升级到 3.8.8 并正常打开
  • 从空项目做原型,或在现有游戏项目中搭建场景、制作界面、编辑脚本与动画
  • 希望 AI 通过编辑器操作修改游戏项目,并能核对结果、构建发布和试玩
  • 编辑器与 AI 编程 Agent 不在同一台电脑,或需要多个 AI 编程 Agent 同时接入

:no_entry_sign: 这类期待它不承接:

  • 希望给一条需求就自动生成可直接发行的完整游戏
  • 希望插件自带 AI 大模型,或代替你判断结果对错

:ambulance: 安装失败、连不通时怎么办

现象 处理
安装后在「扩展」菜单里找不到插件 确认导入的是插件压缩包本身(不是解压出来的子目录),并在「已安装扩展」页签确认开关已开启;手动解压放置的方式才需要重启编辑器
换了 AI 编程 Agent 就连不上 用面板「自动配置」按提示重新完成当前 AI 编程 Agent 的接入配置,再重启该 AI 编程 Agent;仍不通可联系客服协助
预览一片空白,或构建出来画面比例不对 跑一次诊断或构建前比例预检找出原因,按提示给出的修复方向处理

:pushpin: 安装注意事项

  • 插件是项目级扩展:安装在当前打开的 Cocos 项目里,每个项目各装一次;
  • 插件包为 .zip,导入时保持压缩包不变;导入不可用时才改为手动解压放置。

:open_book: 使用教程

用「」括起的文字表示界面上可直接点击的菜单、页签或按钮。

:inbox_tray: 第 1 步 · 安装插件

Cocos Store商店本插件产品链接,限时优惠中:
https://store.cocos.com/app/detail/10014

从 Cocos Store「已购资源」下载插件包,保持 zip、先不要解压。 用 Cocos Creator 3.8.8 编辑器打开你要开发的项目,顶部菜单「扩展」→「扩展管理器」,点工具栏上的导入图标,选中插件包即可;切到「已安装扩展」页签,能看到插件且右侧开关为开启状态,即完成安装。

图 1 · 在「扩展管理器」点导入图标后,选中插件包,点「打开」。

图 2 · 「已安装扩展」页签里插件已加载,右侧开关为开启状态。

图 3 · 安装完成后,插件目录位于当前开发项目的 extensions 下。

:desktop_computer: 第 2 步 · 打开 MCP Server 面板

「扩展」→「Cocos MCP AI Master」→「打开 MCP Server 面板」。面板显示服务地址与端口,运行状态可见。

图 4 · 「MCP Server」面板首页,服务地址与运行状态可见。

:electric_plug: 第 3 步 · 接入你的 AI 编程 Agent

点面板「自动配置」,按面板提示完成接入配置,重启该 AI 编程 Agent 后,即可在对话里调用编辑器能力。实际端口以插件面板提示为准:

{
  "mcpServers": {
    "cocos-mcp": {
      "url": "http://127.0.0.1:3600/mcp"
    }
  }
}

图 5 · 「MCP 客户端配置」页提供服务地址与配置示例,并列出常见 AI 编程 Agent。

:key: 第 4 步 · 激活并验证

  1. 在编辑器里激活:「扩展」→「Cocos MCP AI Master」→ 打开 MCP Server 面板 → 点「激活插件」→ 粘贴激活码 → 点「激活」;面板右上角显示账号 / 类型 / 套餐 / 剩余四项即完成。
  2. 验证接通:在你的 AI 编程 Agent 里发一条简单指令(例如「列出当前场景的层级」),能拿到编辑器返回的结果即接通完成。

安装或激活过程中遇到问题,可通过下方「联系作者」联系客服协助处理。

图 6 · 在面板右上角完成激活:首次点「激活插件」,已激活后从「变更激活码」进入同一弹窗。

:speech_balloon: 联系作者

客服微信二维码

欢迎反馈实际使用中的问题,每个反馈都会被认真对待。

:mega: 更新声明

  • 1.0.0
    • Cocos MCP AI Master 首个正式版本:Cocos Creator 3.8.8 编辑器扩展插件(MCP Server 工具);
    • 20+ 个 MCP 工具、200 个以上可调用动作,覆盖从场景搭建到构建试玩的主要环节;
    • 内置 Cocos 实战知识库,包含常用设置、取值约束与常见坑;
    • 支持结果核对、交互试玩、玩家视角截图,节点与组件等编辑类改动可在编辑器里撤销;
    • 支持本机、局域网与自行配置的隧道接入,购买后凭激活码启用。

:shopping_cart: 购买须知

Cocos Store商店本插件产品链接:
https://store.cocos.com/app/detail/10014

本产品为付费虚拟商品,一经购买成功概不退款,请支付前谨慎确认购买内容。

激活码获取:在 Cocos Store 下单付费后,联系客服即可获取激活码与售后服务支持(建议优先加客服微信 GameAIMaster)。

许可声明:插件包、源码与文档的著作权归作者所有;购买获得的是在你自己的项目中使用本插件的授权。未经作者书面许可,不得复制、转售、再分发插件包或源码,也不得将本插件代码或其衍生代码用于其他产品。

:warning: 责任边界:

  • 本插件是 Cocos Creator 3.8.8 编辑器的扩展插件,无法独立运行,请先安装该版本编辑器。本产品不提供 AI 大模型 API 服务,AI 大模型需由用户自行通过正规渠道获取与配置。

**:warning: 免责说明:**本产品按现状提供,AI 生成的内容可能存在偏差,用户应在使用中自行校验结果(包括但不限于节点结构、资源引用、构建产物)。文中提及的软件与 AI 编程 Agent 名称,仅用于说明兼容性,相关商标归各自所有者所有。


Cocos Store商店本插件产品链接,限时优惠中:
https://store.cocos.com/app/detail/10014

支持一下!不过感觉MCP形势都快不需要了,我用Cursor直接修改文件半年了,很快大模型和Agent就能完全理解工程和编辑器了。

感谢这位朋友的友情支持哈,在此以产品会友。暂时国内AI大模型还不行,国外大模型国内不容易用上。阶段性,MCP工具还是有用的,尤其是很多Cocos领域知识散落在各种零碎文档里,甚至很多的隐形知识和各种实战踩过的坑都藏在资深Cocos专家的脑袋里,对于初步接触Cocos或了解不深的开发者,MCP工具还是大幅降低了入门门槛,让天下没有难做的游戏!AI时代会大大激发个人的创造力,让人人都是产品经理。哈哈

你的mcp和别人的优势是什么 而且 商店链接都没有

今天刚提交的cocos store发布申请,等审核中。有兴趣,可以加我联系方式,可以发你详细产品介绍。

给Cocos Store审核人员点赞啊,今天上传Cocos Store的首发插件。今天就审核通过。限时优惠,欢迎大家前往这个插件资源链接进行购买:
Cocos Store商店本插件资源链接:
https://store.cocos.com/app/detail/10014