convez.ai
MCP ServerDesenvolvimento WebAvançado
andsky

Cocos MCP Server

andsky/cocos-mcp-server

Automação do Cocos Creator via IA com 20 ferramentas e 80+ operações

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que expõe operações do editor Cocos Creator como ferramentas acessíveis por IA. Permite que Claude, Cursor e outros assistentes manipulem cenas, nós, componentes, assets e executem builds via linguagem natural. Integra-se nativamente ao protocolo MCP para automação completa de desenvolvimento de jogos.

Instalação

$npx convez-ai andsky/cocos-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
0
Acompanhando
0
Saúde
14%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Gerar estruturas de cenas e hierarquias de nós automaticamente
  • Criar e configurar UI (labels, buttons, layouts) via descrição natural
  • Gerenciar assets, prefabs e dependências em lote
  • Executar builds e previews sem interação manual no editor
  • Controlar animações e propriedades de componentes via comando

Veredito

Ferramenta muito técnica e especializada para desenvolvedores Cocos Creator que querem automação por IA. A cobertura de 80+ operações é robusta, mas requer familiaridade tanto com MCP quanto com o editor Cocos para extrair valor máximo. Ideal para pipelines de desenvolvimento acelerado.

README

A tradução para o português deste README ainda está na fila.

Cocos MCP Server

通过 MCP 协议让 AI 助手(Claude、Cursor 等)直接操作 Cocos Creator 编辑器。

Version Cocos Creator License: MIT

这是什么

MCP(Model Context Protocol)是一种让 AI 助手调用外部工具的标准协议。本插件把 Cocos Creator 编辑器的操作暴露为 MCP 工具,AI 可以直接:

  • 创建/删除/移动节点
  • 挂载组件、设置属性
  • 管理预制体和资源
  • 控制场景视图
  • 运行预览和构建

简单说:你用自然语言描述需求,AI 帮你在编辑器里干活。

快速开始

安装

把本目录放到项目的 extensions/ 下:

YourProject/extensions/cocos-mcp-server/

安装依赖并编译:

cd extensions/cocos-mcp-server
npm install && npm run build

重启 Cocos Creator,菜单栏出现 扩展 → Cocos MCP Server → Open Panel。

启动服务器

打开面板后点击 Start Server,默认监听 http://127.0.0.1:3000/mcp。

连接 AI 助手

Claude CLI:

claude mcp add --transport http cocos-creator http://127.0.0.1:3000/mcp

Claude Desktop / Cursor:

在 MCP 配置中添加:

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

连接成功后,AI 助手就能调用编辑器操作了。

工具一览

20 个统一工具,80+ 操作。每个工具通过 action 参数指定具体操作。

场景与节点

工具操作说明
scene_managementget, list, open, save, create, close, hierarchy场景管理
node_lifecyclecreate, delete, duplicate节点增删复制
node_queryget, find, findBy, all节点查找
node_transformset, move, reset位置/旋转/缩放
selection_manageget, set, clear编辑器选中状态

组件与 UI

工具操作说明
component_manageadd, remove, get, info, set组件增删改查
ui_componentlabel, sprite, button, layout, widget, progress, editbox, slider, toggleUI 控件快捷操作
script_manageattach, create, compile, query, methods, execute, properties脚本管理

资源与预制体

工具操作说明
asset_manageimport, create, delete, copy, move, info, query, list资源 CRUD
asset_analyzedependencies, unused, validate, batch, manifest资源分析
prefab_lifecyclecreate, update, revert, duplicate预制体管理
prefab_browselist, load, info, instantiate预制体浏览与实例化

编辑器与调试

工具操作说明
project_managerun, build, info, settings, refresh项目控制
build_systembuild, preview, settings, status, open, start, stop构建流水线
scene_viewfocus, align, gizmo, grid, mode, camera, reset, status场景视图
preferences_manageget, set, reset, export, import, open, list编辑器偏好
debug_consoleget, clear, execute控制台访问
broadcast_messagelisten, stop, send, log, clear, listeners编辑器内部通信
server_infostatus, connectivity, network, port, ip, restart, quit服务器信息
animation_manageclip, component, state, track, play, pause, stop, record动画控制

使用示例

{ "tool": "node_lifecycle",  "arguments": { "action": "create", "name": "Player", "parentUuid": "uuid", "nodeType": "2DNode" }}
{ "tool": "ui_component",    "arguments": { "action": "label", "nodeUuid": "uuid", "text": "Hello", "fontSize": 24 }}
{ "tool": "animation_manage", "arguments": { "action": "play", "nodeUuid": "uuid", "clipName": "run", "loop": true }}
{ "tool": "script_manage",   "arguments": { "action": "attach", "nodeUuid": "uuid", "scriptPath": "db://assets/scripts/Player.ts" }}
{ "tool": "prefab_browse",   "arguments": { "action": "instantiate", "prefabPath": "db://assets/prefabs/Enemy.prefab", "parentUuid": "uuid" }}

配置

面板中可配置:

项默认值说明
端口3000HTTP 监听端口
自动启动关闭编辑器启动时自动开启服务器
调试日志关闭输出详细 MCP 通信日志
允许来源*CORS 来源限制
最大连接数5同时连接的 AI 客户端数

项目结构

source/
├── main.ts                  # 扩展入口
├── mcp-server.ts            # HTTP + MCP 协议服务
├── settings.ts              # 配置持久化(async fs)
├── scene.ts                 # 场景脚本(引擎上下文)
├── types/index.ts           # 共享类型 + VERSION
├── panels/default/          # 编辑器面板(Vue 3)
└── tools/
    ├── index.ts             # 工具注册表
    ├── unified-tool-base.ts # 抽象基类
    └── *.ts                 # 20 个工具文件

添加新工具

  1. 创建 source/tools/my-tool.ts,继承 UnifiedToolBase
  2. 在 source/tools/index.ts 的 TOOL_CLASSES 数组中注册
  3. npm run build — 工具自动注册到 MCP tools/list

详见 CLAUDE.md 中的"添加新工具"章节。

常见问题

Q: AI 连不上服务器? 检查编辑器面板中服务器状态是否为 running,端口是否被占用。

Q: 操作报权限错误? 确保场景已保存且未被其他进程锁定。

环境

  • Cocos Creator ≥ 3.8.6
  • TypeScript 5.x(开发依赖)

License

MIT

Ver o original no GitHub

Bom para

Relacionados