Playcanvas Editor MCP Server

🚀 MCP 服務器：用於自動化 PlayCanvas 編輯器的大型語言模型驅動工具

MCP 服務器是一款藉助大型語言模型實現 PlayCanvas 編輯器自動化操作的工具。它能通過一系列命令完成如創建實體、修改材質屬性等多種操作，為開發者提供便利。

🚀 快速開始

MCP 服務器是一個用於自動化 PlayCanvas 編輯器的 MCP（Multi - Chatgpt Panel）服務器項目，支持通過大語言模型（LLM）進行操作。以下將為您詳細介紹其使用方法。

✨ 主要特性

MCP 服務器支持豐富的命令，可實現多種功能，涵蓋實體創建、模型格式轉換、場景保存等多個方面，具體如下：

1. 創建實體：create_entities
2. 刪除所有實體：delete_all_entities
3. 修改材質屬性：modify_material_properties
4. 調整網格縮放：adjust_mesh_scale
5. 設置變換矩陣：set_transform_matrix
6. 添加剛體動力學：add_rigidbody_dynamics
7. 刪除選定物體：delete_selected_objects
8. 導出場景到 JSON：export_scene_to_json
9. 導入外部模型：import_external_model
10. 重置所有變換：reset_all_transforms
11. 啟用碰撞檢測：enable_collision_detection
12. 禁用粒子系統：disable_particle_system
13. 修改光源強度：modify_light_intensity
14. 添加腳本組件：add_script_component
15. 刪除材質引用：delete_material_references
16. 創建空物體：create_empty_object
17. 克隆選定對象：clone_selected_object
18. 應用模方網格：apply_m模具_glass
19. 轉換模型格式：convert_model_format
20. 保存當前場景：save_current_scene

📦 安裝指南

步驟 1：安裝 MCP 服務器

在終端中運行以下命令以安裝 MCP 服務器：

npm install

步驟 2：安裝 Chrome 擴展

將 mcp-editor/dist/mcp_editor.zip 文件解壓並安裝到您的瀏覽器擴展程序中。

🔧 技術細節

配置 MCP 服務器

根據您使用的操作系統，配置文件如下所示： Windows 系統：

{
  "mcpServers": {
    "playcanvas": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "tsx",
        "C:\\路徑\\到\\mcp-editor\\src\\server.ts"
      ]
    }
  }
}

macOS 系統：

{
  "mcpServers": {
    "playcanvas": {
      "command": "npx",
      "args": [
        "tsx",
        "/路徑/到/mcp-editor/src/server.ts"
      ]
    }
  }
}

驅動 MCP 服務器

方法 1：使用 Claude Desktop

1. 安裝 Claude Desktop。
2. 打開 Claude 設置，找到 mcp.json 文件並配置如下：

{
  "mcpServers": {
    "playcanvas": {
      "command": "npx",
      "args": [
        "tsx",
        "/路徑/到/mcp-editor/src/server.ts"
      ]
    }
  }
}

方法 2：使用 Cursor

1. 安裝 Cursor。
2. 打開設置，進入 File > Preferences > Cursor Settings。
3. 點擊 + 添加新的全局 MCP 服務器，配置如下：

{
  "mcpServers": {
    "playcanvas": {
      "command": "npx",
      "args": [
        "tsx",
        "/路徑/到/mcp-editor/src/server.ts"
      ]
    }
  }
}

📄 注意事項

⚠️ 重要提示

目前，MCP 服務器需要由 Anthropic 的 Claude 驅動。我們的經驗表明，Claude 的免費層提供的上下文窗口較小（約 4k tokens），可能不足以處理複雜的 PlayCanvas 項目。因此，我們強烈推薦使用 Claude Pro 賬號以獲得更好的體驗。

💡 使用建議

1. 推薦使用 Claude Pro：Claude 的免費層上下文窗口較小（約 4k tokens），可能無法滿足 PlayCanvas 項目的需求。建議升級至 Claude Pro。
2. 啟用自動運行模式：在 Cursor 設置中，進入 Features 部分，啟用 Enable auto - run mode 以允許 LLM 自動運行 MCP 工具。注意：此功能存在風險，請謹慎使用。
3. 選擇合適的代理模式：在 Cursor 中，確保選擇 Agent 模式。Ask 和 Edit 模式將無法識別 MCP 服務器命令。

通過以上步驟，您可以成功配置並運行 MCP 服務器，實現對 PlayCanvas 編輯器的自動化操作！