Funplay Cocos MCP server

Funplay MCP for Cocos An Embedded MCP Server for Cocos Creator Editor 中文 | English

If this project helps your Cocos workflow, please consider giving it a Star. It helps more developers discover the project and supports ongoing development.

Funplay MCP for Cocos is an MIT-licensed Cocos Creator extension that embeds an HTTP MCP server directly inside the editor. It lets AI assistants such as Claude Code, Cursor, Codex, VS Code Copilot, Trae, Kiro, Qoder, Kimi Code, and OpenCode inspect and operate your running Cocos project.

The package follows the same product direction as Funplay MCP for Unity: keep the default tool surface focused, provide a one-click client configuration window, and make one high-flexibility execution tool the primary workflow.

For Cocos, the primary tool is execute_javascript:

• context: "scene" runs JavaScript in the active Cocos scene/runtime context
• context: "editor" runs JavaScript in the Cocos editor/browser context

"Create a login page UI with account/password fields and a main login button."

Your AI assistant can call execute_javascript, build the UI hierarchy under the active Canvas, attach Cocos components, inspect the result, and capture a screenshot for validation.

Quick Start

If you just want to connect quickly, do these three things:

• Install this repository as a Cocos Creator extension
• Open Funplay > MCP Server
• Use the built-in one-click MCP client configuration

1. Install as a Cocos Creator Extension

Recommended install: use the official Cocos Store page and install the extension into your target Cocos Creator project.

For local development or unreleased builds, clone or copy this repository into your Cocos project extension directory:

cd /path/to/your-cocos-project
mkdir -p extensions
git clone https://github.com/FunplayAI/funplay-cocos-mcp.git extensions/funplay-cocos-mcp

Then restart Cocos Creator or reload extensions from the editor.

For a non-git install, download Funplay.CocosMcp.v.zip from the GitHub Releases page, unzip it, and move the extracted funplay-cocos-mcp folder into your project extensions/ directory.

Install for All Projects (Recommended)

Install and open the extension in any project first. Then open Funplay > MCP Settings and click Install for All Projects in the All Projects section. The extension downloads the latest GitHub Release, verifies SHA256SUMS.txt, and installs it into the active Cocos Creator version's managed global extension directory:

• macOS / Linux: ~/.CocosCreator/builtin-extensions//funplay-cocos-mcp
• Windows: %USERPROFILE%\.CocosCreator\builtin-extensions\\funplay-cocos-mcp

Cocos Creator scans and registers the installed copy immediately. Projects opened or created with that Creator version then load it automatically, and the MCP server keeps its default autostart behavior. Reopen an already-running project if its project-level copy has priority. No extension files are copied into each project's extensions/ directory.

Shortened. The full README is on GitHub.