MCP-сервер Cocos (игровой движок).
claude mcp add --transport http cocos-creator http://127.0.0.1:3000/mcp(使用你自己配置的端口号) Claude客户端配置: { "mcpServers": { "cocos-creator": { "type": "http", "url": "http://127.0.0.1:3000/mcp" } } } Cursor或VS类MCP配置 { "mcp一个适用于 Cocos Creator 3.8+ 的综合性 MCP(模型上下文协议)服务器插件,使 AI 助手能够通过标准化协议与 Cocos Creator 编辑器进行交互。一键安装和使用,省去所有繁琐环境和配置。已经测试过Claude客户端Claude CLI和Cursor,其他的编辑器理论上也完美支持。
🚀 现在提供 50 个强力融合工具,实现99%的编辑器控制!
##快速链接
cocos store:https://store.cocos.com/app/detail/7941
{
"tool": "node_lifecycle",
"arguments": {
"action": "create",
"name": "MyNode",
"parentUuid": "parent-uuid",
"nodeType": "2DNode"
}
}
{"__id__": x} 格式nullCannot read properties of undefined (reading '_name') 错误placeHolder.initDefault is not a function 错误_objFlags 等关键属性被组件数据覆盖🎉 现在预制体创建功能已完全可用,支持复杂的组件引用关系和完整的预制体结构!
Claude cli配置:
claude mcp add --transport http cocos-creator http://127.0.0.1:3000/mcp(使用你自己配置的端口号)
Claude客户端配置:
{
"mcpServers": {
"cocos-creator": {
"type": "http",
"url": "http://127.0.0.1:3000/mcp"
}
}
}
Cursor或VS类MCP配置
{
"mcpServers": {
"cocos-creator": {
"url": "http://localhost:3000/mcp"
}
}
}
将整个 cocos-mcp-server 文件夹复制到您的 Cocos Creator 项目的 extensions 目录中,您也可以直接在扩展管理器中导入项目:
您的项目/
├── assets/
├── extensions/
│ └── cocos-mcp-server/ <- 将插件放在这里
│ ├── source/
│ ├── dist/
│ ├── package.json
│ └── ...
├── settings/
└── ...
cd extensions/cocos-mcp-server
npm install
npm run build
扩展 > Cocos MCP Server 打开控制面板从 扩展 > Cocos MCP Server 打开 MCP 服务器面板
配置设置:
点击"启动服务器"开始接受连接
服务器在 http://localhost:3000/mcp(或您配置的端口)上提供 HTTP 端点。
AI 助手可以使用 MCP 协议连接并访问所有可用工具。
cocos-mcp-server/
├── source/ # TypeScript 源文件
│ ├── main.ts # 插件入口点
│ ├── mcp-server.ts # MCP 服务器实现
│ ├── settings.ts # 设置管理
│ ├── types/ # TypeScript 类型定义
│ ├── tools/ # 工具实现
│ │ ├── scene-tools.ts
│ │ ├── node-tools.ts
│ │ ├── component-tools.ts
│ │ ├── prefab-tools.ts
│ │ ├── project-tools.ts
│ │ ├── debug-tools.ts
│ │ ├── preferences-tools.ts
│ │ ├── server-tools.ts
│ │ ├── broadcast-tools.ts
│ │ ├── scene-advanced-tools.ts (已整合到 node-tools.ts 和 scene-tools.ts)
│ │ ├── scene-view-tools.ts
│ │ ├── reference-image-tools.ts
│ │ └── asset-advanced-tools.ts
│ ├── panels/ # UI 面板实现
│ └── test/ # 测试文件
├── dist/ # 编译后的 JavaScript 输出
├── static/ # 静态资源(图标等)
├── i18n/ # 国际化文件
├── package.json # 插件配置
└── tsconfig.json # TypeScript 配置
# 安装依赖
npm install
# 开发构建(监视模式)
npm run watch
# 生产构建
npm run build
source/tools/ 中创建新的工具类ToolExecutor 接口mcp-server.ts 初始化中插件完全使用 TypeScript 编写,具备:
npm run build 检查 TypeScript 错误在插件面板中启用调试日志以获取详细的操作日志。
{
"tool": "debug_get_console_logs",
"arguments": {"limit": 50, "filter": "error"}
}
{
"tool": "debug_validate_scene",
"arguments": {"checkMissingAssets": true}
}
本插件供 Cocos Creator 项目使用,并且源代码一并打包,可以用于学习和交流。没有加密。可以支持你自己二次开发优化,任何本项目代码或者衍生代码均不能用于任何商用、转售,如果需要商用,请联系本人。