cocos-creator-mcp-server

Controls the Cocos Creator 3.8+ editor through MCP tools for scenes, nodes, components, prefabs, and assets.

7|2|Updated May 16, 2026
One-click install
npx skills add https://github.com/reason-machines/mcp-skills --skill cocos-creator-mcp-server-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cocos-creator-mcp-server
Source: https://github.com/reason-machines/mcp-skills/tree/main/skills/cocos-creator-mcp-server
Command: npx skills add https://github.com/reason-machines/mcp-skills --skill cocos-creator-mcp-server-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually building scenes, wiring components, and managing prefabs in Cocos Creator is repetitive and slow. This Skill lets an AI assistant drive the editor directly through the Model Context Protocol, automating scene creation, node manipulation, component scripting, and asset management. ## Core Features & Use Cases - Editor Automation via MCP: Exposes 50 tools covering scenes, nodes, components, prefabs, assets, project builds, debugging, and preferences through a unified action-plus-parameters pattern. - Prefab and Asset Workflows: Create prefabs from nodes, instantiate them at positions, apply or revert instance changes, and query or import assets by type. - Use Case: Ask your AI assistant to create a new Level1 scene, add a background sprite node and a UI canvas, attach a PlayerController script with custom properties, then save the scene and run a web-mobile build. ## Quick Start Install the plugin from the Cocos Store, enable it in the Extension Manager, then add an MCP server entry pointing to http://127.0.0.1:3000/mcp in your Claude Desktop or Cursor configuration and ask the AI to create a new scene with a sprite node.

Frequently Asked Questions about cocos-creator-mcp-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Claude to Cocos Creator?▼

Install the Cocos Creator MCP Server plugin from the Cocos Store or GitHub, enable it in the Extension Manager, then add an MCP server entry with type http and url http://127.0.0.1:3000/mcp to claude_desktop_config.json or run claude mcp add for the CLI.

How to create and instantiate prefabs in Cocos Creator with MCP?▼

Use prefab_lifecycle with action create, passing a source node UUID and a db:// save path. Then call prefab_instance with action instantiate, the prefab UUID, and an optional parent UUID and position to spawn copies in the scene.

Does the Cocos Creator MCP server work with Cursor and VS Code?▼

Yes, any MCP-compatible client works, including Claude Desktop, Claude CLI, Cursor, and VS Code with MCP extensions. Configure the client with the server URL http://localhost:3000/mcp matching the port set in the plugin's MCP panel.

Why does removing a component fail in Cocos Creator MCP?▼

Removal fails when you pass a script name instead of the component's exact cid. First call component_query with action get_components to retrieve the type field such as comp.MyScript!abc123, then pass that exact value as componentType to the remove action.

What Cocos Creator versions are supported by the MCP plugin?▼

The plugin requires Cocos Creator 3.8.6 or higher, with plugin version 1.5.0 or later recommended. Version 1.4.0 and above fixed prefab reference loss issues, so older versions may lose component or asset references.

Why won't the MCP server start in Cocos Creator?▼

The server usually fails because the default port 3000 is already in use or the extension is disabled. Check port usage with netstat, pick a different port in the MCP panel, confirm the extension is enabled, and restart the editor.