mcpField
M
MCP-Editor

MCP-Editor

本地服务
github.com/playcanvas媒体与设计1492 周前更新
代码仓库

关于 MCP-Editor

MCP-Editor 是供 AI Agent 自动化 PlayCanvas Editor 项目的 MCP 服务，涵盖项目与资源编辑，也可启动场景并检查运行状态。

主要功能

  1. 01编辑项目、实体、场景和资源
  2. 02管理脚本、模板与动画
  3. 03处理纹理、模型等资源
  4. 04启动场景并检查运行状态
  5. 05管理构建、商店导入和 VCS

适用场景

  1. 01在打开的项目中创建或修改场景
  2. 02运行场景并截取屏幕截图
  3. 03通过 AI Agent 编辑资源和脚本

MCP 相关

该服务向 MCP 客户端提供 PlayCanvas Editor 项目、编辑、处理、运行时和 VCS 工具；操作对象是已连接 Editor 中打开的项目。

#javascript#webgl#typescript#mcp#playcanvas#webgpu#webxr#mcp-server#vibe-coding

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "editor": {
      "command": "npx",
      "args": [
        "-y",
        "tsx"
      ],
      "env": {
        "PORT": "<PORT>"
      }
    }
  }
}
启动命令npx -y tsx
需要配置的环境变量
PORT

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmtsx

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

PlayCanvas 编辑器 MCP 服务

npm Version CI License Context Discord Reddit X

| npm | 开发者网站 | 编辑器手册 | API 参考 | 博客 | 论坛 |

一个 MCP 服务，可让 AI Agent 自动操作 PlayCanvas Editor，并检查场景是否能正常运行。MCP 客户端内置于编辑器中，因此无需浏览器扩展。

由 MCP 客户端驱动的 PlayCanvas 编辑器

安装

将此服务添加到 MCP 客户端。以 Claude Code 为例：

claude mcp add playcanvas -- npx -y @playcanvas/editor-mcp-server

需要 Node.js 22.18 或更高版本。每个 Agent 只添加一次此服务：两个服务会轮流占用编辑器端口。

Claude Desktop、Cursor 和共享项目的 .mcp.json 
{
  "mcpServers": {
    "playcanvas": {
      "command": "npx",
      "args": ["-y", "@playcanvas/editor-mcp-server"]
    }
  }
}

将此内容添加到 claude_desktop_config.json（Settings > Developer > Edit Config）、Cursor 的全局 MCP 服务（Cursor Settings > MCP），或提交到项目根目录中供 Claude Code 使用的 .mcp.json。在 Windows 上，请使用 "command": "cmd" 和 "args": ["/c", "npx", "-y", "@playcanvas/editor-mcp-server"]。

Codex CLI 和应用 
codex mcp add playcanvas -- npx -y @playcanvas/editor-mcp-server

在 Windows 上，请在 npx 前插入 cmd /c。如果首次运行时 npx 正在下载导致超时，请在 ~/.codex/config.toml 的 [mcp_servers.playcanvas] 下调高 startup_timeout_sec。

然后在编辑器中打开项目，点击 Publish 下方的 MCP 按钮，再点击 CONNECT。若要在未打开项目时启动，请点击 playcanvas.com/editor 上 NEW PROJECT 旁边的 MCP 按钮。出现提示时，请允许 Chrome 使用 Apps on device 权限；如果编辑器一直停留在 Connecting，说明权限遭到拦截。默认端口为 52000；如需更改，请向服务传入 --port <number>，并在编辑器中设置相同的端口。

使用方法

告诉 Agent 你希望在当前打开的项目中实现什么结果。例如：

Add a spinning cube with a rotate script to the current scene, launch it, and capture a screenshot
of the running app to confirm it turns.

工具

类别功能范围
项目列出、精确读取、创建，编辑名称、描述和可见性，以及在已连接的 Editor 中打开项目
实体精确读取、筛选列表、解析、搜索、查找脚本、创建、安全符合架构的批量编辑、复制、层级更改、删除和组件生命周期管理
脚本读取和写入资源文本、解析、附加、属性、排序和移除
资源精确读取、引用关系图、原生创建、流式上传和原子下载（最大 512 MiB）、安全符合架构的编辑、移动、复制、替换源文件、重新导入、删除和材质
模板实例化和检查实例覆盖项、应用、还原和解除链接
动画读取和编辑动画状态图、安全映射状态重命名和动画事件
处理光照贴图、模型展开和取消、纹理转换、图集、立方体贴图、字体、元数据、压缩变体、预过滤、精灵和资源包
场景精确读取、列出、加载、创建、复制、重命名、删除和场景设置
设置读取和编辑项目、私有、用户、会话和场景范围的设置
视口摄像机和视口状态、可见性、捕获和聚焦
Editor选择、编辑时日志、变换操纵器状态、撤销和重做
构建列出、精确读取、创建选项、流式下载、选择主构建和删除
商店搜索和导入 PlayCanvas Store 内容、许可证、搜索和导入 Sketchfab 内容，以及搜索和导入“我的资源”
运行时启动生命周期和选项、引擎版本发现、屏幕截图、日志、实时状态检查，以及键盘、鼠标和触控输入
VCS分支、检查点、还原和硬重置、合并、冲突解决和检查点差异

工具会操作已连接 Editor 中打开的项目，每次只能连接一个 Editor。即使没有打开项目，项目工具也可在 playcanvas.com/editor 的项目管理器中使用；打开项目后，标签页会重新加载并进入该项目，且自动重新连接。项目无法删除。运行时工具会打开一个 Launch 窗口，因此请允许 Editor 弹出窗口。

上下文占用

130 个工具定义总计约 43,000 个 token（每个 token 4 个字符）。Claude Code 的 MCP 工具搜索默认开启，启动时仅加载工具名称，约占 1,000 个 token。

数据和网络使用

该服务不收集遥测数据。它会在 127.0.0.1:52000 上监听 playcanvas.com 和 localhost 页面，停止任何占用该端口的其他进程，仅在上传和下载工具中访问本地文件，并且只发出一个出站请求：download_build 会获取 Editor 报告的存档 URL。

贡献

git clone https://github.com/playcanvas/editor-mcp-server.git
cd editor-mcp-server
npm install
npm run watch

将 MCP 客户端指向 src/server.ts，并设置 "command": "node"。npm run debug 会打开 MCP Inspector，npm run build 会生成发布包。请在 GitHub Issues 中报告错误。

许可证

PlayCanvas Editor MCP Server 根据 MIT License 发布。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。