适合谁
- 已经在使用 OpenPencil 桌面应用或 CLI，并希望通过 AI 代理自动化设计工作流的团队
- 需要本地、离线、无账号依赖地读写 Figma 兼容文件的开发者
- 希望将设计文件检查/导出集成进 CI 流程的工程团队
O
59FMRS · C
OpenPencil MCP 服务器是开源设计编辑器 OpenPencil（MIT 协议）自带的官方组件，通过 stdio 或本地 HTTP 方式向 Claude Code、Cursor、Windsurf 等 MCP 客户端暴露 100 余个设计操作工具，用于无头检查、修改、导出 .fig/.pen 文件。README 未给出具体工具的规范标识符，故工具清单为空；其 eval 能力可执行完整 Figma Plugin API 脚本，赋予较高的文件修改权限，需要注意脚本执行风险，且该项目为非官方的 Figma 替代品，仍处于活跃开发阶段。
OpenPencil 是一款开源的设计编辑器（MIT 协议），可读写 .fig 和 .pen 设计文件，内置 AI 助手，并提供无头 Vue SDK。其 @open-pencil/mcp 包提供 MCP 服务器，支持 stdio 方式接入 Claude Code、Cursor、Windsurf 等客户端，也提供本地 HTTP/Unix socket 方式供脚本和 CI 使用。README 中说明该服务器暴露 100 多个设计工具，可用于创建/修改节点、管理自动布局、处理组件与变量、执行布尔运算、分析设计令牌以及导出资源，但未在源材料中列出具体工具的规范名称，因此工具清单留空。文件访问可通过 OPENPENCIL_MCP_ROOT 环境变量限定目录范围。
工具能力
暂未整理工具清单。
安装接入
- 全局安装 CLI 包：
npm install -g @open-pencil/mcp。 - 在 Claude Code 中注册：
claude mcp add --scope user open-pencil -- openpencil-mcp，或在其他 MCP 客户端的配置文件中添加{"mcpServers": {"open-pencil": {"command": "openpencil-mcp"}}}。 - 如需 HTTP 方式（脚本、CI），运行
openpencil-mcp-http，本地客户端会自动发现 Unix socket，并回退到http://127.0.0.1:7600/mcp；如需禁用 TCP 可设置PORT=0（macOS/Linux）。 - 如需限定文件操作范围，设置环境变量
OPENPENCIL_MCP_ROOT指向目标目录，否则默认使用当前工作目录。 - 若通过 Claude Code 的桌面代理面板使用，还需在
~/.claude/settings.json的permissions.allow中加入mcp__open-pencil__*。
claude_desktop_config.json
{
"mcpServers": {
"open-pencil": {
"command": "openpencil-mcp"
}
}
}
选型与风险
不适合谁
- 需要官方 Figma 支持或官方托管服务的用户（OpenPencil 是非官方的第三方替代品，与 Figma 无关联）
- 只想要只读、无脚本执行能力的最小权限场景（eval 工具可执行完整 Figma Plugin API 脚本）
- 不熟悉命令行/MCP 配置、只想用图形界面的非技术用户
所需权限
- 通过 OPENPENCIL_MCP_ROOT 限定的本地文件系统读写权限（默认是当前工作目录）
- 在桌面应用运行时，可通过 RPC 连接并操作实时打开的画布/文档
- HTTP 传输模式下监听本地 Unix socket 及 127.0.0.1:7600 端口
风险与副作用
- eval 相关能力暴露完整 Figma Plugin API，可对设计文件执行任意脚本，存在误操作或恶意脚本篡改/删除设计数据的风险
- 项目处于活跃开发阶段（README 明确说明存在功能边角问题），行为可能随版本变化
- 该项目是非官方的 Figma 替代品，与 Figma 官方无关，不代表 Figma 或 MCP 协议方的兼容性保证
常见排障
- 若 CLI 无法连接实时画布，确认 OpenPencil 桌面应用是否已启动（RPC 连接依赖桌面应用运行）
- 若文件操作被拒绝，检查 OPENPENCIL_MCP_ROOT 是否正确指向目标目录
- 在 Claude Code 中若工具调用被权限拦截，检查 ~/.claude/settings.json 是否已添加 mcp__open-pencil__* 权限
- 使用 HTTP 传输时，若本地 Unix socket 不可用，确认回退的 127.0.0.1:7600 端口未被占用，或按需设置 PORT=0
使用场景
让 AI 编码代理（如 Claude Code）以无头方式检查、修改、导出 .fig / .pen 设计文件
在 CI 或脚本流水线中通过 HTTP 方式自动化设计文件的 lint、格式转换和资源导出
构建面向设计系统审计的自动化流程，如提取颜色/排版/间距等设计令牌
支持客户端
Claude Code完整支持
Cursor完整支持
Windsurf完整支持