Editor MCP Server

🚀 PlayCanvas 編輯器的自動化 MCP 服務器

本項目藉助大型語言模型 (LLM) 實現了 PlayCanvas 編輯器 的 MCP 服務器自動化。它能有效提升 PlayCanvas 編輯器的使用效率和便捷性，為開發者帶來更好的體驗。

⚠️ 重要提示

目前，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. 點擊 加載 unpacked 並選擇 extensions 文件夾。
3. 加載 PlayCanvas 編輯器，此時 Chrome 擴展應該已成功加載。

運行 MCP 服務器

MCP 服務器可以通過 Cursor 或 Claude Desktop 驅動。

💡 使用建議

經測試，Claude Desktop 通常更可靠。

Claude Desktop

1. 安裝 Claude Desktop。
2. 轉到 Claude > Settings。
3. 選擇 Developer 然後 Edit Config。
4. 這將打開 claude_desktop_config.json，即你的 MCP 配置 JSON 文件。

Cursor

1. 安裝 Cursor。
2. 選擇 File > Preferences > Cursor Settings。
3. 點擊 + 添加新的全局 MCP 服務器。
4. 這將打開 mcp.json，即你的 MCP 配置 JSON 文件。

💡 使用建議

在 Cursor 設置中，在 Features 下滾動到 Chat 部分，啟用 Enable auto-run mode 可允許 LLM 在無需持續授權的情況下運行 MCP 工具，但此操作需自行承擔風險（不過我們更推薦這樣做）！

⚠️ 重要提示

在 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 擴展以打開擴展程序彈出窗口。
4. 選擇 CONNECT（端口號應與你在 MCP 配置 JSON 文件中設置的端口匹配）。

⚠️ 重要提示

目前，只能將一個 PlayCanvas 編輯器實例連接到 MCP 服務器。