安装
npx -y @figwright/mcp@latest适合谁
如果你希望 AI 代理不只是“看看”Figma，而是通过本地 WebSocket 中继连上官方插件，既读设计又写画布，这个免费双向 MCP 对得上。它面向 Claude Code、Cursor、Codex 以及任何 MCP 客户端。一共 113 个工具，覆盖读、写和 grounding，所以代理既能按设计实现，也能在画布上搭建。它跑在 Figma 免费档，不像官方 Dev Mode MCP 那样要付费席位。它适合本机设计协作，不适合在没有桌面端、或插件未连上时调用写工具，也不适合把 113 个未点名工具当成已知 API。摘要称数据留在本机；读文件和写画布仍是本地隐私边界，不是“没有本地读取”。
3 分钟完成第一次尝试
先确认 MCP 客户端、Figma 桌面端，以及 Node.js 20.19+ 或 22.12+。官方写明不支持 Node 18/21 和 22.0–22.11；服务器由 npx 单独拉起，版本可与项目构建用的 Node 不同。免费档即可，但导入插件需要桌面应用。客户端主配置为：
npx -y @figwright/mcp@latest
不需要全局安装。启动后按仓库说明在 Figma 桌面导入插件，并确认本地 WebSocket 中继已连通。先做低风险读取：在客户端列出的工具里选只读或 grounding，查看当前选区或页面结构。证据没有点名这 113 个工具；缺了就按清单调用，不要发明图层 API。成功信号是返回设计结构，而不是画布被改写。写画布前必须先看到读取成功。可选的 npx skills add awdr74100/figwright/skills 不是主路径，且技能要求 MCP 已连接。仓库： https://github.com/awdr74100/figwright
使用案例
案例一：按设计实现。插件连通后，用读取/grounding 类工具理解框架感知的设计结构，再在本机产出代码。标题写明可把设计变成框架感知代码。证据没有写支持哪些框架名称；缺了就以客户端返回的结构为准，不要补造导出格式。
案例二：把结果写回画布。要用代理在 Figma 里搭建或回推代码时，使用写画布工具。这会改设计文件，属于有副作用的动作：先确认当前文件是可丢弃副本或你明确要改的文件，再执行。证据只保证双向、非只读；没有撤销步骤。失败时以 Figma 历史为准，不要发明 undo 命令。
使用边界
没有桌面端就导不进插件，中继也就连不上。Node 版本不符时不要硬跑。113 个工具名未公布，禁止自行编造。写操作会改画布；只读成功前不要批量写入。官方 Dev Mode MCP 的付费限制不适用于 Figwright，但 Figwright 也不是 Figma 官方席位替代品。技能包是附加物，不能代替 @figwright/mcp。不要假设代理看不到你的设计文件。第一次尝试只走 npx -y @figwright/mcp@latest，成功信号定为一次只读结构返回。