figma-custom-mcp

一个轻量级 MCP + Figma 插件，修补了 Plumb 中三个已确认的具体能力缺口——它不修改、复刻或替换 Plumb，设计上在 Figma 中与 Plumb 配对使用。

这些缺口及其完整的源码级证据均记录在 PLUMB_GAP_ANALYSIS.md 中（基于 Plumb v0.13.2 的源码审计报告）。本项目仅实现审计中标记为 P0 的项目：

• P0-1 — 绝对定位/重叠定位。 Plumb 的 DSL 编译器强制每个容器采用自动布局，且始终不设置 Figma 的 layoutPositioning="ABSOLUTE"，导致重叠组合（徽章在图像上、文字在照片上等）在结构上无法构建。本项目编译器默认使用自由 (x/y) 定位，并支持在自动布局区域内使用 absolute: true 子节点。

• P0-2 — 本地/自定义图片导入。 Plumb 的 image.src 始终编译为针对六个固定图库提供商的网络搜索查询；用户的本地文件永远无法进入 Plumb 构建的设计。本项目直接读取 file:/data: URI，提供类型化错误，且不使用任何占位符替换。

• P0-3 — 严格模式 schema 校验。 Plumb 的 Zod schema 静默丢弃未知/拼写错误的字段。本项目的每个 schema 均使用 .strict()。

完整的逐项审计追踪请参见 docs/P0-CAPABILITY-MATRIX.md，其余文档集请参见 docs/。

状态

P0 已完成——参见 P0-FINAL-REPORT.md 获取完整的验收标准清单、实机 Figma 测试结果，以及本项目构建的实际合成效果截图（真实的 Figma 重叠节点、真实的本地图片、真实的旋转/渐变/效果——非扁平化图像）。

Related MCP server: Figma Bridge MCP

快速入门

npm install
npm run build
npm test

然后请参阅 docs/QUICKSTART.md 以配对 Figma 插件并运行实时端到端测试。

文档

• docs/ARCHITECTURE.md

• docs/P0-CAPABILITY-MATRIX.md

• docs/P0-TOOLS.md

• docs/P0-DESIGN-SCHEMA.md

• docs/P0-TEST-PLAN.md

• docs/P0-IMPLEMENTATION.md

• docs/P0-LIMITATIONS.md

• docs/QUICKSTART.md

许可证

MIT