mcp-bridge

MCP Bridge 插件为 Cocos Creator 2.4.x 提供对外的 MCP (Model Context Protocol) 接口。通过本服务，外部 AI 工具或编辑器可以远程调用 Cocos Creator 编辑器的功能，例如获取和修改场景节点、管理资源、创建脚本、执行菜单项以及批量操作等。服务端通过一个标准的 HTTP 接口暴露多种 MCP 工具，支持分步获取场景层级、批量执行任务、以及对资源与组件的细粒度操作。此外，插件具备并发安全、超时保护和参数别名映射等智能特性，确保在大模型场景下的鲁棒性。你可以在你的 AI 编辑器（如 Cursor、VS Code 等）中配置一个 MCP 代理连接，后续发送 MCP 指令即可实现对虚拟场景的无人干预操作。

准备工作

• 先确认使用的 Cocos Creator 版本为 2.4.x，且具备编辑器的网络访问能力。
• 安装 Node.js（推荐 v14+）以运行托管的 MCP 代理脚本。

安装步骤

1. 将该插件复制到你的 Cocos Creator 项目中的 packages 目录下（例如：[项目根]/packages/mcp-bridge）。
2. 启动编辑器，打开 MCP 面板：MCP Bridge/Open Panel，并点击 Start 启动服务。默认监听端口为 3456。
3. 也可以在你自己的 AI 编辑器中通过配置连接到代理，例如运行 mcp-proxy.js 的 Node 命令。示例命令和配置如下：

代码示例（命令行）

node [你的项目根路径]/packages/mcp-bridge/src/mcp-proxy.js

配置示例（JSON，外部编辑器连接时使用）

{
  "mcpServers": {
    "cocos-creator": {
      "command": "node",
      "args": ["[你的项目根路径]/packages/mcp-bridge/src/mcp-proxy.js"]
    }
  }
}

注意事项

• 如果默认端口被占用，插件会自动尝试端口+1 的方案，请确保本机网络可达该端口。
• 确保项目目录中存在 settings/mcp-bridge.json（或插件自带的配置管理）以便在不同项目之间隔离配置。

提示与常见问题：

• 端口与自动启动：可以在 settings/mcp-bridge.json 里配置自动启动，以及监听端口。若要在编辑器启动时自动开启，请设置相应项。
• 安全性：为了防止 AI 对关键引用造成不可预期的修改，插件具备属性保护和引用查找等安全特性，避免直接修改 node/uuid 等核心引用。
• 资源与异步加载：在 manage_component 对资源属性（如材质、纹理、 prefab 等）进行新增或更新时，插件会自动处理 UUID 映射和异步资源加载。
• 调试日志：服务端提供实时日志输出，默认会写入项目内的日志文件，便于排错。
• 若遇到编辑器未刷新资源的问题，请在执行对组件挂载的脚本创建后调用 refresh_editor（传递准确路径）以确保 .meta 文件正确生成。