OpenPencil MCP Server

社区

面向 OpenPencil 开源 AI 设计编辑器的 MCP 服务器

分类: 其他第 83 / 230
Stars: ★ 9.6k 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js
凭据: 无需凭据
许可证: MIT
最近提交: 今天

59FMRS · C

OpenPencil MCP 服务器是开源设计编辑器 OpenPencil（MIT 协议）自带的官方组件，通过 stdio 或本地 HTTP 方式向 Claude Code、Cursor、Windsurf 等 MCP 客户端暴露 100 余个设计操作工具，用于无头检查、修改、导出 .fig/.pen 文件。README 未给出具体工具的规范标识符，故工具清单为空；其 eval 能力可执行完整 Figma Plugin API 脚本，赋予较高的文件修改权限，需要注意脚本执行风险，且该项目为非官方的 Figma 替代品，仍处于活跃开发阶段。

最强项 · 文档质量 15/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

11/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: 未提供服务器清单（manifest 显示 [not cached]），无法核实 MCP 初始化/工具列表握手是否与文档中声称的“100+ 工具”一致。README 提到 bun run test / test:unit 等质量门禁命令，但未见实际 CI 工作流文件或测试覆盖 MCP 服务器关键路径的证据，属于静态评审中“未经验证”的情形。根据静态校准规则，在缺乏可验证执行证据时可靠性不得超过 12 分；由于连清单本身都缺失，进一步扣分至 8 分。
安全与权限 12/20: MCP 文件访问通过 OPENPENCIL_MCP_ROOT 环境变量进行目录范围限定，体现了一定的最小权限意识；AI 功能为 BYOK（用户自带密钥），密钥不经服务器托管，降低了凭证泄露风险。但 CLI/eval 功能暴露完整 Figma Plugin API 并可通过 -w 标志写回文件，属于高影响力的操作面；README 及 MCP 相关章节未说明 MCP 工具层对破坏性操作（如覆盖文件、写入操作）是否有二次确认机制。未发现红线问题（无恶意代码、无凭证窃取、无默认不可逆操作、无示例中的真实密钥），但权限边界与确认机制披露不完整，故评为中等偏上。
维护活跃度 11/20: 项目采用 MIT 许可证，仓库未被归档，说明书中提及“Active development”及后续路线图（roadmap）链接，显示一定的持续投入。但 README 本身未披露发布节奏、版本策略、安全响应渠道（如 SECURITY.md）或维护团队治理结构的具体证据；仅有一名文档维护者被致谢，暗示核心维护资源有限。星标数与 open issue 数量仅作为发现信号，不计入加分，因此维护活跃度证据总体偏薄弱。
文档质量 15/20: README 内容详实，涵盖安装方式（Homebrew/下载/网页版）、CLI 用法示例、MCP 服务器 stdio/HTTP 两种连接方式、实际 JSON 配置示例、环境变量说明（OPENPENCIL_MCP_ROOT），并链接至外部文档站点、llms.txt/llms-full.txt 及 BYOK 提供商兼容性文档，体现了分层文档结构。不足之处在于 README 未内嵌完整的 100+ 工具参数列表（依赖外部链接，无法在本次评审中核实），且缺少专门的故障排查（troubleshooting）章节。
安装易用性 13/20: MCP 服务器的安装步骤清晰：npm 全局安装、claude mcp add 命令、供其他客户端使用的 JSON 配置示例，以及面向脚本/CI 场景的 HTTP 模式，步骤简洁且给出了具体命令。但根据静态校准规则，在没有实际 CI 工作流或已提交测试验证这些安装步骤可行性的情况下，安装易用性不得超过 15 分；同时可执行文件与二进制发布物的兼容性、跨平台细节未在源码层面得到验证，故评为 13 分。

静态评测 · 未实际运行收录于 2026-08-06

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码

适合谁

已经在使用 OpenPencil 桌面应用或 CLI，并希望通过 AI 代理自动化设计工作流的团队
需要本地、离线、无账号依赖地读写 Figma 兼容文件的开发者
希望将设计文件检查/导出集成进 CI 流程的工程团队

不适合谁

需要官方 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 协议方的兼容性保证

安装接入

准备工作

运行环境：Node.js

其他可选配置项（1 个）

OPENPENCIL_MCP_ROOT 可选将 open_file、new_document 及导出路径限制在指定目录内；默认为当前工作目录。可选。

全局安装 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__*。

.mcp.json

{
  "mcpServers": {
    "open-pencil": {
      "command": "openpencil-mcp"
    }
  }
}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "open-pencil": {
      "command": "openpencil-mcp"
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add open-pencil -- openpencil-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

安装 `npm install -g @open-pencil/mcp` 并执行 `claude mcp add --scope user open-pencil -- openpencil-mcp` 后，在客户端工具列表中应出现 open-pencil 的 MCP 工具；也可让 AI 对某个 .fig 文件运行 tree/inspect 查询来验证连接。

常见排障

若 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 助手这样说：

打开 design.fig 并列出所有宽度小于 300px 的 Frame
检查这份设计文件里的命名和可访问性问题
把当前画布导出为 PNG
提取这份设计文件中使用的颜色调色板

使用场景

让 AI 编码代理（如 Claude Code）以无头方式检查、修改、导出 .fig / .pen 设计文件

在 CI 或脚本流水线中通过 HTTP 方式自动化设计文件的 lint、格式转换和资源导出

构建面向设计系统审计的自动化流程，如提取颜色/排版/间距等设计令牌

支持客户端

Claude Code

Cursor

Windsurf

依据项目文档列出，未经本站实测。

详细介绍

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 环境变量限定目录范围。