Cocos MCP Tools

Install the MCP server package globally via npm. This provides the cocos-mcp command that your AI client will launch to communicate with the editor.

npm install -g cocos-mcp

Add the cocos-mcp server to your MCP client config. For VS Code with Cline, open MCP Settings and add the server. On Windows use 'cmd /c cocos-mcp'; on macOS/Linux use the global node_modules path.

{
  "mcpServers": {
    "cocos": {
      "command": "cmd",
      "args": ["/c", "cocos-mcp"]
    }
  }
}

On macOS or Linux, point directly to the installed package's entry point since a global command alias may not be in the PATH used by your editor.

{
  "mcpServers": {
    "cocos": {
      "command": "node",
      "args": ["/usr/local/lib/node_modules/cocos-mcp/dist/index.js"]
    }
  }
}

Download the cocos-mcp-tools Creator plugin from the GitHub repository. Install it into your Cocos Creator project by placing it in the extensions folder and enabling it in the editor under Extensions → Plugin Manager. The plugin registers the actual MCP tools.

In your AI client, disable and re-enable the cocos-mcp server to trigger a fresh tool discovery. Because tools are dynamically provided by the Creator plugin, they only appear once the plugin is active and the server refreshes.