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 编辑器的自动化操作！