Zed的纸张MCP服务器扩展
此扩展集成 纸张的MCP服务器作为上下文服务器 Zed的 Agent Panel,支持AI驱动的设计到编码工作流程。
先决条件
- 纸质桌面应用 必须正在运行(将MCP暴露在
http://127.0.0.1:29979/mcp) - Node.js 必须安装(用于
mcp-remote桥梁)
安装
- 从Zed的扩展市场安装扩展
- 确保Paper桌面应用程序正在运行
- 将以下内容添加到Zed设置中(
~/.config/zed/settings.json):```json
"context_servers": {
"paper": {}
}
4. 重新启动Zed或重新加载窗口
## 可用工具
连接后,Zed的AI助手可以使用以下工具:
|工具|说明|
|------|-------------|
| `getBasicInfo` |获取当前设计的基本上下文:文件名、页面名、节点数和带尺寸的画板列表。首先调用此命令以了解画布情况。 |
| `getSelection` |获取当前选定节点的详细信息,包括ID、名称、组件类型、大小以及它们所属的画板|
| `getNodeInfo` |按ID获取特定节点的详细信息,包括其大小、可见性、锁定状态、父节点、子节点ID和文本内容(对于文本节点)。 |
| `getChildren` |获取节点的直接子节点。返回子节点的列表,包括其ID、名称、组件类型以及每个子节点的数量。有助于探索设计层次结构。 |
| `getScreenshot` |按ID捕获特定节点的PNG屏幕截图。将图像作为base64编码数据返回。 |
| `getJSX` |获取节点及其子代的JSX代码表示。支持两种样式格式:顺风CSS类(默认)或内联样式。 |
| `getTreeSummary` |获取节点子树层次结构的简洁文本摘要。返回一个缩进树,显示每个节点的组件类型、名称、ID和维度。在理解结构方面比getJSX便宜得多——在深入特定节点之前,将其用于定向。 |
| `getComputedStyles` |获取一个或多个节点的计算CSS样式。返回nodeId到CSSProperties对象的映射。支持批量请求。 |
| `findPlacement` |在画布上找一个空白位置放置新的画板。返回避免重叠现有画板的x/y坐标。在使用writeHTML创建新画板之前调用此命令。 |
| `getFillImage` |从具有图像填充的节点中提取图像数据。返回具有MIME类型的base64编码数据形式的图像。 |
| `writeHTML` |将HTML写入设计中。HTML被解析并转换为Paper设计节点。有两种模式可供选择:“插入子节点”将节点添加为目标的子节点,“替换”删除目标并将解析后的HTML插入其位置。 |
| `createArtboard` |在画布上创建一个新的画板(顶级框架)。自动将其定位在不与现有画板重叠的空白区域。返回画板ID,然后您可以将其与writeHTML插入子项一起使用以添加内容。 |
| `deleteNodes` |从设计中删除一个或多个节点。同时删除指定节点的所有子代。 |
| `setTextContent` |设置一个或多个文本节点的文本内容。仅适用于组件类型为“Text”的节点。当您只需要更改文本时,请使用此选项而不是writeHTML替换。支持单次调用中的批量更新。 |
## 运作原理
此扩展使用 `mcp-remote` 将Paper的HTTP/SSE MCP服务器连接到Zed的基于stdio的上下文服务器接口。扩展程序会自动运行:```bash
npx -y mcp-remote http://127.0.0.1:29979/mcp
本地使用
要在本地使用此扩展:
- 克隆此存储库:```bash
git clone https://github.com/SeedOfMany/zed-mcp-server-paper.git
cd zed-mcp-server-paper
1. 确保Paper桌面应用程序正在运行
1. 在Zed中,打开命令面板(`Cmd+Shift+P`)并运行:```
zed: install dev extension
-
出现提示时选择克隆目录
-
添加到Zed设置(
~/.config/zed/settings.json):```json
"context_servers": {
"paper": {}
}
1. 重新加载Zed以应用更改
### 调试
从终端运行Zed,并记录详细日志:```bash
zed --foreground
关于纸
纸是创造美丽艺术和体验的强大设计工具。了解更多信息,请访问 纸.设计.
许可证
MIT许可证-请参阅 许可证 了解详情。
