Cocos Creator MCP 是什么？能做什么，和「Cocos Creator AI」差在哪

在 Cocos Creator 工程里用 AI 写 TypeScript，往往只能看见磁盘上的脚本与配置；当前场景树、未保存的节点改动、组件属性与预制体引用，多数仍要人在编辑器里点。VberAI Cocos Creator MCP（下文简称 Cocos MCP）做的是另一件事：在 Creator 内跑本地 MCP 服务，让 Cursor、Claude Code、Codex 等支持 MCP 的客户端，按协议调用已打开编辑器里的操作面——而不只是改仓库文件。

它不是新的游戏引擎，也不替代 Creator 的渲染、构建与发包。能力以当前插件版本为准；下文按品类说明边界，不展开安装逐步截图。

它解决什么问题

常见卡点是上下文断层：

只有磁盘侧 AI 时	接入 Cocos MCP 后
能改 .ts / 配置，但不知道当前场景开着什么	可查询打开场景的节点层级与关键属性
脚本写完，还要手点挂组件、摆节点、对预制体	可在约定工具范围内创建/调整节点、挂组件、做预制体相关操作
「编辑器里刚才那次改动」对仓库快照不可见	以编辑器实时状态为上下文（仍须人验收）

适合已经在用 AI 写脚本、又希望减少「脚本对了、场景对不上」往返的团队。工程仍在 Cocos Creator 2.x 或 3.x——两套插件分开，勿混用压缩包。

能做什么（典型场景）

具体工具名与操作码会随版本迭代，更稳妥的理解是能力类别，而不是某一版的工具条数：

1. 场景与层级 — 打开/保存相关场景操作，查询节点树，做小范围可逆改动
2. 节点与组件 — 创建或调整节点，增删引擎组件与脚本挂载，改常见属性
3. 预制体与资源 — 预制体浏览/实例化等辅助；资源查询与基础管理（以插件暴露的工具为准）
4. 调试辅助 — 读取控制台或日志、做场景完整性类检查，便于定位「改完跑不起来」

建议习惯：先只读冒烟（例如列出当前场景根节点），再小步写入，最后在 Creator 里 Play / 预览验收。MCP 加速的是编辑器重复操作，不取消人工审改。

产品入口：

• Cocos MCP 3.x
• Cocos MCP 2.x

不能指望它做什么

期望	实际边界
用 MCP「一键把 Figma 变成完整 UI 预制体」	设计稿结构化导入属于 VberAI Studio；MCP 在资源进工程后再做编辑器内迭代
自动完成移动端压包、渠道优化、发行配置	仍属 Creator 构建与发布管线，不是 MCP 自带魔法
不打开 Creator、只靠远端服务改你的线上工程	桥接默认跑在本机 localhost；应对准当前打开的工程
2.x 工程装 3.x 包（或反过来）也能用	分插件；混用是装不上、连不上的常见原因
模型改完即可上线	与 Unity / Godot MCP 一样：改动要在编辑器里跑通并纳入版本管理

开源版与 Pro 的差异、订阅与激活方式以官网当前说明为准；本文不展开商业条款。

「Cocos Creator AI」通常指什么

搜索里的 Cocos Creator AI 往往是笼统说法，并不对应单一官方产品名。对照常见意图：

说法 / 工具形态	主要上下文	典型产出
磁盘向代码助手（补全、改仓库）	脚本与配置文件	代码补丁
文档 / 问答类「Cocos 助手」	文档与 API 说明	文字解答，不直接动你的场景
VberAI Studio	PSD / Figma 等设计结构	更接近引擎语义的 UI 层级与资源交接
Cocos MCP	已打开的 Creator 编辑器	场景、节点、组件、预制体等编辑器侧操作

若目标是「让 Cursor 看见并改当前场景」，对应的是 MCP 编辑器桥接，而不是换一个只会答文档的聊天机器人，也不是用 MCP 硬扛切图与布局壳导出。

VberAI 产品栈里三者可组合、勿混称：抠图准备素材 → AI Studio 做界面结构交接 → Cocos MCP 在编辑器内接线与改节点。总览见：VberAI 是什么。

和「只改代码的 AI」差在哪

维度	以仓库为中心的 AI	Cocos MCP
主要上下文	磁盘上的脚本与资源	编辑器对象树与当前工程状态
常见动作	写/改 TypeScript	查层级、改节点与组件、辅助预制体与调试
验收	编译与单测仍有用	还需在 Creator 视口与预览里确认

两者可以并存：逻辑与架构仍可用原有编码习惯；需要碰编辑器对象时再走 MCP。

若还在 Unity / Godot 与 Cocos 之间选型，见：Godot MCP vs Unity MCP vs Cocos MCP。

下一步

1. 确认工程是 3.x 还是 2.x，下载对应插件包
2. 按安装文完成导入、激活、启动服务，并在 AI IDE 里看到 cocos-creator（或面板显示的服务名）
3. 只读列出根节点 → 一次可逆小写入 → 编辑器验收

安装与排障：

• Cocos Creator 3.x MCP 安装
• Cocos Creator 2.x MCP 安装
• Cocos MCP 连接失败排查
• Cursor 连上后像坏了 / 连不上

视频向配置也可参考：Cocos Creator MCP 视频指南。

常见问题

Cocos Creator MCP 是什么？
VberAI Cocos Creator MCP 是把 Cursor、Claude Code、Codex 等 MCP 客户端接到已打开的 Cocos Creator 编辑器的桥接插件：可查询/操作场景、节点、组件与预制体（以插件版为准）。它不是新引擎，也不替代 Creator 的渲染与发版。

和「Cocos Creator AI」有什么区别？
「Cocos Creator AI」多为笼统搜索说法，不对应单一官方产品。文档问答、纯代码助手、AI Studio（设计稿进引擎）、MCP（编辑器桥接）是不同能力。要让 Cursor 看见并改当前场景，对应的是 MCP。

2.x 和 3.x 能混用同一个 MCP 包吗？
不能。按工程大版本下载对应插件，勿混用压缩包。安装见 3.x 与 2.x。

Cursor 连上后像坏了怎么办？
按症状排查：列表无服务、红错、已连无工具。短文：Cursor 连 Cocos MCP 坏了；通用四层：连接失败排查。