Playcanvas Editor MCP Server

MCP Server是一個用於通過LLM自動化PlayCanvas編輯器的工具，支持多種操作如創建、修改、複製和刪除實體等。

開發者工具遊戲與遊戲化 #自動化工具 #PlayCanvas #LLM驅動遠程 .TypeScript

評分 : 2分

下載量 : 4.3K

更新時間 : 2025-04-28

打開站點

什麼是PlayCanvas MCP Server?

MCP服務器是一個連接大型語言模型(LLM)與PlayCanvas編輯器的橋樑，允許開發者通過自然語言命令自動化執行編輯器操作，如創建/修改實體、管理腳本、處理材質等

如何使用MCP Server?

通過Claude或Cursor等支持MCP協議的客戶端發送自然語言指令，服務器會將其轉換為PlayCanvas編輯器可執行的操作

適用場景

適用於需要批量操作PlayCanvas項目的場景，如自動化構建場景結構、批量修改組件屬性、快速生成測試腳本等

主要功能

實體管理

創建/修改/複製/刪除場景實體，支持層級結構調整

組件控制

添加/移除實體組件，管理組件屬性

腳本編輯

創建新腳本、修改腳本內容、解析腳本結構

材質創建

創建新材質並設置漫反射等屬性

場景設置

查詢和修改場景全局設置

資源管理

實例化模板資源、刪除資源、列出資源

優勢

通過自然語言簡化複雜操作流程

支持PlayCanvas編輯器大部分核心功能

可批量執行重複性任務

與Claude/Cursor等AI工具深度集成

侷限性

需要Claude Pro賬號以獲得最佳效果

部分複雜操作可能需要多次指令才能完成

首次配置需要技術知識

即時性受網絡延遲影響

如何使用

安裝依賴

運行npm install安裝所有依賴項

安裝Chrome擴展

在chrome://extensions/中加載解壓的擴展程序

配置MCP服務器

根據平臺(Windows/macOS)編輯MCP配置JSON文件

啟動服務

在Claude或Cursor中啟動MCP服務器連接

使用案例

創建基礎場景

快速搭建包含地面、光源和相機的初始場景

批量修改材質

將所有使用特定材質的物體顏色改為紅色

自動化測試腳本

為場景中的每個交互元素添加測試腳本

常見問題

為什麼推薦使用Claude Pro?

如何確認MCP服務器已正確連接?

可以同時執行多個命令嗎?

操作失敗時如何調試?

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

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

🚀 快速開始

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

✨ 主要特性

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

創建實體：create_entities
刪除所有實體：delete_all_entities
修改材質屬性：modify_material_properties
調整網格縮放：adjust_mesh_scale
設置變換矩陣：set_transform_matrix
添加剛體動力學：add_rigidbody_dynamics
刪除選定物體：delete_selected_objects
導出場景到 JSON：export_scene_to_json
導入外部模型：import_external_model
重置所有變換：reset_all_transforms
啟用碰撞檢測：enable_collision_detection
禁用粒子系統：disable_particle_system
修改光源強度：modify_light_intensity
添加腳本組件：add_script_component
刪除材質引用：delete_material_references
創建空物體：create_empty_object
克隆選定對象：clone_selected_object
應用模方網格：apply_m模具_glass
轉換模型格式：convert_model_format
保存當前場景：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

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

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

方法 2：使用 Cursor

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

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

📄 注意事項

⚠️ 重要提示

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

💡 使用建議

推薦使用 Claude Pro：Claude 的免費層上下文窗口較小（約 4k tokens），可能無法滿足 PlayCanvas 項目的需求。建議升級至 Claude Pro。

啟用自動運行模式：在 Cursor 設置中，進入 Features 部分，啟用 Enable auto - run mode 以允許 LLM 自動運行 MCP 工具。注意：此功能存在風險，請謹慎使用。

選擇合適的代理模式：在 Cursor 中，確保選擇 Agent 模式。Ask 和 Edit 模式將無法識別 MCP 服務器命令。

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