PlayCanvas Editor MCP Server

一个用于自动化 PlayCanvas 编辑器 的 MCP 服务器，使用 LLM。

<img width="1864" alt="Screenshot 2025-03-21 at 15 50 10" src="https://github.com/user-attachments/assets/393ffe73-40eb-4e1b-9442-2295bbb63326" />

[!IMPORTANT] 目前，MCP 服务器需要由 Anthropic 的 Claude 驱动。我们的经验表明，Claude 的免费层级无法提供足够大的聊天上下文来可靠地运行 MCP 服务器。因此，我们强烈建议订阅 Pro Claude 帐户。

可用工具

• 实体
  • list_entities
  • create_entities
  • delete_entities
  • duplicate_entities
  • modify_entities
  • reparent_entity
  • add_components
  • remove_components
  • add_script_component_script
• 资源
  • list_assets
  • create_assets
  • delete_assets
  • instantiate_template_assets
  • set_script_text
  • script_parse
  • set_material_diffuse
• 场景
  • query_scene_settings
  • modify_scene_settings
• 商店
  • store_search
  • store_get
  • store_download

安装

运行 npm install 安装所有依赖项。

安装 Chrome 扩展

1. 访问 chrome://extensions/ 并启用开发者模式
2. 点击 加载已解压的扩展程序 并选择 extensions 文件夹
3. 加载 PlayCanvas 编辑器。 扩展程序应该已加载。

运行 MCP 服务器

MCP 服务器可以由 Cursor 或 Claude Desktop 驱动。

[!TIP] 我们发现 Claude Desktop 通常更可靠。

Claude Desktop

1. 安装 Claude Desktop。
2. 转到 Claude > 设置。
3. 选择 开发者，然后选择 编辑配置。
4. 这将打开 claude_desktop_config.json，您的 MCP 配置 JSON 文件。

Cursor

1. 安装 Cursor。
2. 选择 文件 > 首选项 > Cursor 设置。
3. 点击 + 添加新的全局 MCP 服务器。
4. 这将打开 mcp.json，您的 MCP 配置 JSON 文件。

[!TIP] 同样在 Cursor 设置 中，选择 功能 并滚动到 聊天 部分。 激活 启用自动运行模式 以允许 LLM 运行 MCP 工具，而无需持续授权。 您需要自行承担风险（但我们更喜欢它）！

[!IMPORTANT] 在 Cursor 中，确保您已选择 Agent。 Ask 和 Edit 模式将无法识别 MCP 服务器。

MCP 配置 JSON 文件

这是您的配置应如下所示：

Windows

{
  "mcpServers": {
    "playcanvas": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "tsx",
        "C:\\path\\to\\mcp-editor\\src\\server.ts"
      ],
      "env": {
        "PORT": "52000"
      }
    }
  }
}

macOS

{
  "mcpServers": {
    "playcanvas": {
      "command": "npx",
      "args": [
        "tsx",
        "/path/to/mcp-editor/src/server.ts"
      ],
      "env": {
        "PORT": "52000"
      }
    }
  }
}

将编辑器连接到 MCP 服务器

PlayCanvas 编辑器不会自动连接到 MCP 服务器。 要连接：

1. 激活一个运行 PlayCanvas 编辑器的 Chrome 标签页。
2. 选择地址栏右侧的扩展程序图标。
3. 选择 PlayCanvas Editor MCP Extension 以打开扩展程序弹出窗口。
4. 选择 连接（端口号应与您的 MCP 配置 JSON 文件中设置的端口号匹配）。

[!NOTE] 您目前一次只能将一个 PlayCanvas 编辑器实例连接到 MCP 服务器。

现在您应该能够在 Claude Desktop 或 Cursor 中发出命令。