# cocos-creator-mcp-server

Wires an AI assistant to the Cocos Creator 3.8.6+ editor over MCP: scenes, nodes, components, prefabs and assets through 50 tools.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 221 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/cocos-creator-mcp-server/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/cocos-creator-mcp-server

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill cocos-creator-mcp-server -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/cocos-creator-mcp-server/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/cocos-creator-mcp-server/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill cocos-creator-mcp-server -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/cocos-creator-mcp-server/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill cocos-creator-mcp-server -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/cocos-creator-mcp-server/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/cocos-creator-mcp-server
```

2. **Manually: put the files in place**
- File: `.github/skills/cocos-creator-mcp-server/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill cocos-creator-mcp-server -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/cocos-creator-mcp-server
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/cocos-creator-mcp-server/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill cocos-creator-mcp-server -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/cocos-creator-mcp-server/SKILL.md

## When to use it
- 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.Sprite` to a node and bind a texture in one call
- read editor console output without leaving the chat

## Example prompts
- Open `db://assets/scenes/Level1.scene` and 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

## Similar
- [Funplay Cocos MCP](https://affpapa.org/en/nevibecode/mcp/funplay-cocos-mcp.md) — MCP server · ★ 423 repo stars
- [game-development](https://affpapa.org/en/nevibecode/skills/sickn33-game-development.md) — skill · 3900 installs
- [bevy-ecs](https://affpapa.org/en/nevibecode/skills/bevy-ecs.md) — skill · 10400 installs
- [godot](https://affpapa.org/en/nevibecode/plugins/godot.md) — plugin · ★ 10033 repo stars
- [Summer Engine](https://affpapa.org/en/nevibecode/mcp/summer-engine.md) — MCP server · ★ 111 repo stars
- [Cinevva Game Creator](https://affpapa.org/en/nevibecode/mcp/cinevva-game-creator.md) — MCP server

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
