https://github.com/playcanvas/editor-mcp-server
MCP Server for AI automation of the PlayCanvas Editor
https://github.com/playcanvas/editor-mcp-server
javascript mcp mcp-server playcanvas typescript vibe-coding webgl webgpu webxr
Last synced: 7 days ago
JSON representation
MCP Server for AI automation of the PlayCanvas Editor
- Host: GitHub
- URL: https://github.com/playcanvas/editor-mcp-server
- Owner: playcanvas
- License: mit
- Created: 2025-03-18T10:20:12.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-04-15T16:00:08.000Z (2 months ago)
- Last Synced: 2025-04-15T16:46:32.253Z (2 months ago)
- Topics: javascript, mcp, mcp-server, playcanvas, typescript, vibe-coding, webgl, webgpu, webxr
- Language: TypeScript
- Homepage:
- Size: 379 KB
- Stars: 38
- Watchers: 4
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- mcp-index - PlayCanvas Editor MCP Server - Automate the PlayCanvas Editor to enhance game development by managing entities, handling assets, and adjusting scene settings efficiently with AI-driven tools. (Content Creation)
README
██████╗ ██╗ █████╗ ██╗ ██╗ ██████╗ █████╗ ███╗ ██╗██╗ ██╗ █████╗ ███████╗
██╔══██╗██║ ██╔══██╗╚██╗ ██╔╝██╔════╝██╔══██╗████╗ ██║██║ ██║██╔══██╗██╔════╝
██████╔╝██║ ███████║ ╚████╔╝ ██║ ███████║██╔██╗ ██║██║ ██║███████║███████╗
██╔═══╝ ██║ ██╔══██║ ╚██╔╝ ██║ ██╔══██║██║╚██╗██║╚██╗ ██╔╝██╔══██║╚════██║
██║ ███████╗██║ ██║ ██║ ╚██████╗██║ ██║██║ ╚████║ ╚████╔╝ ██║ ██║███████║
╚═╝ ╚══════╝╚═╝ ╚═╝ ╚═╝ ╚═════╝╚═╝ ╚═╝╚═╝ ╚═══╝ ╚═══╝ ╚═╝ ╚═╝╚══════╝
███╗ ███╗ ██████╗██████╗ ███████╗███████╗██████╗ ██╗ ██╗███████╗██████╗
████╗ ████║██╔════╝██╔══██╗ ██╔════╝██╔════╝██╔══██╗██║ ██║██╔════╝██╔══██╗
██╔████╔██║██║ ██████╔╝ ███████╗█████╗ ██████╔╝██║ ██║█████╗ ██████╔╝
██║╚██╔╝██║██║ ██╔═══╝ ╚════██║██╔══╝ ██╔══██╗╚██╗ ██╔╝██╔══╝ ██╔══██╗
██║ ╚═╝ ██║╚██████╗██║ ███████║███████╗██║ ██║ ╚████╔╝ ███████╗██║ ██║
╚═╝ ╚═╝ ╚═════╝╚═╝ ╚══════╝╚══════╝╚═╝ ╚═╝ ╚═══╝ ╚══════╝╚═╝ ╚═╝
An MCP Server for automating the [PlayCanvas Editor](https://playcanvas.com/products/editor) using an LLM.
> [!IMPORTANT]
> At the moment, the MCP Server needs to be driven by Anthropic's Claude. Our experience shows that the free tier for Claude does not deliver a big enough chat context to operate the MCP Server reliably. Therefore, we strongly recommend subscribing to a Pro Claude account.
## Available Tools
* Entity
* `list_entities`
* `create_entities`
* `delete_entities`
* `duplicate_entities`
* `modify_entities`
* `reparent_entity`
* `add_components`
* `remove_components`
* `add_script_component_script`
* Asset
* `list_assets`
* `create_assets`
* `delete_assets`
* `instantiate_template_assets`
* `set_script_text`
* `script_parse`
* `set_material_diffuse`
* Scene
* `query_scene_settings`
* `modify_scene_settings`
* Store
* `store_search`
* `store_get`
* `store_download`
## Installation
Run `npm install` to install all dependencies.
### Install Chrome Extension
1. Visit `chrome://extensions/` and enable Developer mode
2. Click `Load unpacked` and select the `extensions` folder
3. Load the PlayCanvas Editor. The extension should be loaded.
### Run MCP Server
The MCP Server can be driven by Cursor or Claude Desktop.
> [!TIP]
> We have found Claude Desktop to be generally more reliable.
#### Claude Desktop
1. Install [Claude Desktop](https://claude.ai/download).
2. Go to `Claude` > `Settings`.
3. Select `Developer` and then `Edit Config`.
4. This will open `claude_desktop_config.json`, your MCP Config JSON file.
#### Cursor
1. Install [Cursor](https://www.cursor.com/).
2. Select `File` > `Preferences` > `Cursor Settings`.
3. Click `+ Add new global MCP server`.
4. This will open `mcp.json`, your MCP Config JSON file.
> [!TIP]
> Also in `Cursor Settings`, select `Features` and scroll to the `Chat` section. Activate `Enable auto-run mode` to allow the LLM to run MCP tools without requiring constant authorization. You do this at your own risk (but we prefer it)!
> [!IMPORTANT]
> In Cursor, ensure you have `Agent` selected. `Ask` and `Edit` modes will not recognize the MCP Server.
#### MCP Config JSON File
This is how your config should look:
Windows
```json
{
"mcpServers": {
"playcanvas": {
"command": "cmd",
"args": [
"/c",
"npx",
"tsx",
"C:\\path\\to\\mcp-editor\\src\\server.ts"
],
"env": {
"PORT": "52000"
}
}
}
}
```
macOS
```json
{
"mcpServers": {
"playcanvas": {
"command": "npx",
"args": [
"tsx",
"/path/to/mcp-editor/src/server.ts"
],
"env": {
"PORT": "52000"
}
}
}
}
```
## Connecting the Editor to the MCP Server
The PlayCanvas Editor does not connect to the MCP Server automatically. To connect:
1. Activate a Chrome tab running the PlayCanvas Editor.
1. Select the Extensions icon to the right of the address bar.
2. Select PlayCanvas Editor MCP Extension to open the extension popup.
3. Select `CONNECT` (the port number should match what is set in your MCP Config JSON File).
> [!NOTE]
> You can currently only connect one instance of the PlayCanvas Editor to the MCP Server at any one time.
You should now be able to issue commands in Claude Desktop or Cursor.