Cocos AI MCP is a Cocos Creator extension developed by Chenshengbiao, designed to embed a Model Context Protocol server directly within the editor. This free tool, built with JavaScript/TypeScript, empowers game developers, technical artists, and AI engineers to automate editor tasks using AI clients. It connects to the Cocos Creator Editor, enabling AI to interact with the development environment locally. The extension supports standard HTTP JSON-RPC 2.0, making it compatible with various AI clients for enhanced workflow capabilities.

What does Cocos AI MCP connect to?

Cocos AI MCP connects directly to the Cocos Creator Editor, functioning as an embedded Model Context Protocol (MCP) server. This integration allows AI clients to interact with the Cocos Creator development environment. The server binds exclusively to 127.0.0.1, ensuring all communication remains local to the machine. This design choice eliminates the need for external authentication mechanisms, simplifying its setup and operation within the Cocos Creator ecosystem.

Core features and tools

The tool exposes specific callable tools, including execute_javascript, which is central for running JavaScript within either the active Cocos scene/runtime context or the Cocos editor/browser context. Debug endpoints like GET /health and GET /tools are also available. The default core profile provides 39 high-signal tools, while a full profile expands this to 105 tools. It supports the HTTP JSON-RPC 2.0 transport protocol, operating on http://127.0.0.1:8765/.

Who is it for?

Cocos AI MCP targets game developers, technical artists, and AI engineers seeking to integrate AI into their development pipeline. It is specifically designed for automating Cocos Creator editor tasks, not for adding runtime dependencies to game builds. This distinction is crucial for maintaining lean game project sizes. Its capabilities are tailored for those who want AI to directly manipulate and inspect their Cocos Creator projects. This is not the right fit if you require AI integration that adds components to your final game build.

How to get started

No credentials are required. The server binds only to 127.0.0.1, keeping all communication local and secure.

Use cases

• Creating UI elements, such as a login page with fields and buttons, by having an AI assistant call execute_javascript to build UI hierarchies and attach components.
• Inspecting and operating a running Cocos project, including mapping file hierarchies and querying or altering scene nodes.
• Authoring or adjusting TypeScript and JavaScript code tailored to engine APIs within the Cocos Creator environment.

Cocos AI MCP offers a direct way to integrate AI assistants into Cocos Creator workflows, focusing on editor automation. Its local binding and standard protocol support make it accessible for developers. The tool provides a powerful mechanism for AI to interact with and modify Cocos projects, enhancing productivity for specific development tasks.