← 返回博客

Cocos Creator MCP 配置教程:连接 Cursor / Claude

配套 YouTube 实操录屏:安装 Cocos Creator MCP 插件、启动本地桥接,并在 Cursor 或 Claude 中完成 Model Context Protocol 配置与连接验证。

发布于
  • cocos
  • cocos-creator
  • mcp
  • cursor
  • claude
  • tutorial
  • video
在 YouTube 观看

观看视频教程

视频: Cocos Creator MCP 配置实操VberAI YouTube 频道

这条录屏是 Cocos Creator MCP 的配置 walkthrough,不是多引擎总览。你会看到如何安装 MCP 插件、启动本地桥接,并把 CursorClaude Desktop 等 AI 客户端接进 Cocos Creator,让助手在编辑器里读写场景与节点。

你将学会什么

跟完视频和下方清单后,你应该能够:

  • 为 Creator 2.x / 3.x 安装并启用 Cocos Creator MCP 插件
  • 在插件面板启动本地 MCP 服务 / 桥接
  • 把服务地址写入 CursorClaudeWindsurf 等支持 MCP 的客户端
  • 做一次只读测试(场景树)和一次小写入测试(新建或重命名节点)

Model Context Protocol(MCP) 暴露的是编辑器实况——当前场景、节点层级、选中项——而不只是磁盘上的文件,因此配置 MCP 对游戏工作流很关键。

前置条件

项目说明
Cocos Creator已打开 2.x 或 3.x 项目
MCP 插件Cocos Creator MCP 扩展(视频中使用 VberAI Cocos MCP
AI 客户端Cursor、Claude Desktop、Claude Code、Windsurf、Cline 等
本机环境桥接运行在 127.0.0.1,需允许本地回环访问

配置步骤(边看边做)

1. 安装 Cocos Creator MCP 插件

  1. Creator 版本 从插件提供方下载 MCP 扩展(见 Cocos MCP 下载页)。
  2. 导入到项目 extensions 目录,或通过 Creator 扩展管理器安装——以插件文档为准。
  3. 打开 扩展 → 扩展管理器,启用 MCP 插件,按提示重载编辑器。

2. 启动 MCP 桥接

打开插件控制面板(菜单名因版本而异,常见为 MCPAI Bridge):

  • 点击 启动服务 / Start MCP
  • 记下面板显示的 本地 URL 和端口(下一步要填进 AI 客户端)

桥接运行期间请保持 Cocos Creator 开启。

3. 配置 AI 客户端

在 MCP 配置中加入桥接地址。以 Cursormcp.json 为例:

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

PORT 替换为插件界面显示的端口。不少 Cocos MCP 构建提供 一键配置 Cursor / Claude 按钮,优先使用复制的 JSON。

保存配置后重启或重载 AI 客户端。

4. 验证连接

在 Cursor 或 Claude 中先问只读问题:

  • 「列出当前场景节点树」
  • 「Canvas 下有哪些子节点?」

应返回编辑器中的结构化路径,而不是凭空猜文件内容。

5. 试一次小写入

做可撤销的小改动:

  • 在选中节点下新建空子节点
  • 重命名命名不规范的 UI 分组
  • 挂一个空脚本或组件

层级 面板确认生效后,再放大到批量自动化任务。

为什么 MCP 比「只改文件」更强

没有 MCP 时,AI 只能看磁盘文件,看不到:

  • 未保存的场景改动与当前选中项
  • 实时的节点属性与组件值
  • 仅存在于编辑器内的上下文(预制体模式、构建设置等)

MCP 把编辑器实况发给模型,这正是 Cocos Creator MCP 的价值。类似桥接架构的工程解读可参考 我们如何为 Godot 打造实时 MCP Server

与「设计稿转 UI」工具配合(可选)

MCP 负责资源进项目之后的编辑器操作;VberAI AI StudioAI Studio)等工具负责 PSD / Figma → 引擎 UI 结构。常见组合:

  1. AI Studio 导入分层界面并导出 Cocos 预制体 / 节点布局
  2. Cocos MCP 在 Creator 里接线、重命名、校验引用

相关教程:3 分钟做出可上线游戏 UI(AI Studio)

常见问题

如何把 Cursor 接到 Cocos Creator?
安装 Cocos Creator MCP → 在编辑器启动桥接 → 把桥接 URL 写入 Cursor 的 mcp.json → 用场景树问题测试。

什么是 Cocos Creator MCP?
基于 Model Context Protocol 的插件,让 AI 客户端通过运行中的编辑器读写 Cocos Creator 项目。

支持哪些 AI 客户端?
凡支持 MCP 的均可:Cursor、Claude Desktop、Claude Code、Windsurf、Cline 等。

视频里讲 Unity / Godot 吗?
不讲——本录屏只演示 Cocos Creator MCP 配置。Unity 请看 Unity MCP 安装教程;Godot 请看 Godot MCP vs 手写脚本

视频链接?
YouTube:Cocos Creator MCP 配置,频道 @vber_ai

延伸阅读

订阅 VberAI YouTube 获取更多 MCP 教程。

你可能还会喜欢这些文章