cocos-creator-mcp-server — Claude Code skill
Wires an AI assistant to the Cocos Creator 3.8.6+ editor over MCP: scenes, nodes, components, prefabs and assets through 50 tools.
no license 221 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill cocos-creator-mcp-server -a claude-codeWhat cocos-creator-mcp-server does
The skill places an MCP server between your assistant and Cocos Creator. Its 50 tools reach scenes, nodes, components, prefabs and assets, and also project builds and console output. Every call takes one shape: a category operation, an action field, then the parameters for that action. The author reckons this halves token use compared with a tool per command and raises the share of calls that go through.
Setup happens on two levels. npx skills add reason-machines/mcp-skills --skill cocos-creator-mcp-server -a claude-code drops the skill file in place. The server itself runs inside the editor, so enable the plugin in Extension Manager and set the port — 3000 unless you change it. Point the client at http://127.0.0.1:3000/mcp, either in claude_desktop_config.json or with claude mcp add --transport http cocos-creator http://127.0.0.1:3000/mcp.
Watch the removal path. A component comes off by its exact cid such as comp.PlayerController!1234abcd, and the script name won't do. Ask for the node's component list first, then copy type from the answer.
What it helps with
- create a scene and save it into
db://assets/scenes/without clicking through the editor - find every node named Player and list what sits on each one
- set a node's position, rotation and scale from a prompt
- attach
cc.Spriteto a node and bind a texture in one call - read editor console output without leaving the chat
Example prompts for the agent
- Open
db://assets/scenes/Level1.sceneand list the root nodes - Create a 2D node called PlayerNode, attach
cc.Sprite, set position to x=100 y=200 - Show the components on every node whose name matches Player
How to install cocos-creator-mcp-server
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill cocos-creator-mcp-server -a claude-code2Manually: put the files in place
~/.claude/skills/cocos-creator-mcp-server/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cocos-creator-mcp-server/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill cocos-creator-mcp-server -a codex2Manually: put the files in place
.agents/skills/cocos-creator-mcp-server/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill cocos-creator-mcp-server -a cursor2Manually: put the files in place
.cursor/skills/cocos-creator-mcp-server/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/cocos-creator-mcp-server2Manually: put the files in place
.github/skills/cocos-creator-mcp-server/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill cocos-creator-mcp-server -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/cocos-creator-mcp-serverManually: put the files in place
.devin/skills/cocos-creator-mcp-server/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill cocos-creator-mcp-server -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about cocos-creator-mcp-server
How do I install cocos-creator-mcp-server in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill cocos-creator-mcp-server -a claude-code; the skill lands at ~/.claude/skills/cocos-creator-mcp-server/SKILL.md. The editor plugin is enabled separately, in Cocos Creator's Extension Manager.
What does cocos-creator-mcp-server do?
It hands the assistant 50 MCP tools for the editor: scenes, nodes, components, prefabs, assets, builds and logs. Calls follow an operation plus action pattern.
Which Cocos Creator version does it need?
Cocos Creator 3.8.6 or newer, plus an MCP-capable client such as Claude Desktop, Claude CLI or Cursor.