Talk to Figma MCP
让支持 MCP 的编码助手可读取并程序化修改 Figma 设计。
按维度查看评分与理由
证据显示：MCP服务器通过WebSocket与Figma插件通信，需要用户手动加入频道（join_channel），但未发现明确的权限最小化设计或用户确认机制。数据流透明度有限，README描述了通信流程但未详细说明数据流向。敏感数据处理未提及，依赖项未固定版本（如uuid、ws使用latest），存在供应链风险。外部影响包括修改Figma文档，但无回滚机制。来源归属：MIT许可证和GitHub用户sonnylazuardi，但发布者未验证。扣分原因：缺乏权限最小化、用户确认、数据流透明、敏感数据处理、依赖安全、外部影响控制、回滚和来源验证。
证据显示：README和代码结构一致，工具列表清晰，但未提供测试或错误处理细节。依赖项如@modelcontextprotocol/sdk版本固定，但其他依赖使用latest，可用性风险。失败消息未详细说明，仅提及所有命令可抛出异常。扣分原因：依赖可用性未保证，失败消息不充分。
证据显示：面向Cursor、Claude Code等AI代理，提供了多种使用场景和最佳实践。能力边界在README中列出，但未明确限制。触发精度通过工具名称和描述体现，但未提供详细参数说明。环境适配包括Windows WSL指南，但未覆盖所有平台。扣分原因：能力边界和触发精度描述不够详细。
证据显示：README结构清晰，安装说明详细，工具命名一致，提供了示例和最佳实践。已知限制未明确列出，版本号存在但无变更日志。许可证为MIT，维护责任未明确。扣分原因：缺少已知限制、变更日志和维护责任说明。
证据显示：输出为Figma操作结果，可用性高，提供了批量操作和自动化功能，边际价值明显。成本效益未量化，但安装和使用简单。扣分原因：成本效益未量化。
证据显示：README中的声明与代码结构一致，但未提供测试或独立验证。跨来源佐证不足，事实与推断未明确区分。扣分原因：缺乏测试和独立验证。
- 依赖项未固定版本，存在供应链风险。
- 未提供用户确认机制，AI代理可能直接修改Figma文档。
- 未提供回滚机制，误操作可能无法恢复。
- 发布者身份未验证，需谨慎使用。
这个 Agent 能做什么，适合哪些场景？
Talk to Figma MCP 是一套连接 AI 编码助手与 Figma 的 MCP 集成。项目包含 TypeScript MCP 服务器、Figma 插件，以及负责二者通信的 WebSocket 服务器。助手通过 MCP 工具读取当前文档、选区和节点信息，并可创建、编辑、组织或导出 Figma 节点。Figma 插件需要加入 WebSocket channel，MCP 服务端随后才能把命令转交给正在打开的 Figma。项目提供面向 Cursor 的安装配置，也将 Claude Code 和 Codex 列为集成目标，但未给出后二者的具体配置步骤。
运行 bun socket 后，src/socket.ts 提供 WebSocket 通信层；Figma 中运行的 src/cursor_mcp_plugin/ 插件通过 join_channel 连接该服务。MCP 服务器可用 get_document_info、get_selection、read_my_design、get_node_info 和 get_nodes_info 读取设计；可用 create_rectangle、create_frame、create_section、create_text 创建节点。它还提供 set_text_content、set_multiple_text_contents、set_fill_color、set_layout_mode、move_node、resize_node、delete_node、clone_node 与 set_parent 等修改操作，并支持注释、组件实例覆盖、原型 reaction 到 FigJam connector 的转换，以及以 PNG、JPG、SVG 或 PDF 导出节点。
- 使用 Cursor 的设计师在打开 Figma 文件后，批量替换多个文本节点的文案。
- 维护设计系统的团队为多个组件实例提取并应用同一组 override。
- 需要检查当前选区或指定节点结构的前端开发者，先用
read_my_design或get_node_info获取设计信息。 - 在大型设计文件中需要按批处理文本的内容运营人员，使用
scan_text_nodes的分块参数扫描后再批量更新。 - 在 FigJam 中需要将 Figma 原型流程可视化的设计人员，读取
get_reactions后创建 connector 线。
这个 Agent 有哪些优点和局限？
- 不仅能读取 Figma 文档和节点，还能创建、移动、调整大小、重命名、删除和重新设置节点父级。
- 提供批量文本更新、批量注释和批量删除等操作，覆盖重复性设计维护任务。
- 支持提取和传播组件实例 override，并可把原型 reaction 转换为 FigJam connector。
- 由 MCP 服务器、Figma 插件和 WebSocket 服务分层组成，Figma 通信路径明确。
- 核心工作流依赖 Figma、其插件和 WebSocket channel，不能作为独立通用设计自动化工具使用。
- 明确的安装配置只覆盖 Cursor；Claude Code 与 Codex 虽被列为集成目标，但没有对应配置说明。
- 需要 Bun、命令行操作和本地运行 WebSocket 服务，增加了桌面环境部署成本。
- 节点图片导出功能标注为有限支持，当前会将 base64 作为文本返回。
- Windows + WSL 场景需要修改
src/socket.ts中的 hostname 设置。
如何安装或部署这个 Agent？
先安装 Bun：curl -fsSL https://bun.sh/install | bash。在仓库目录运行 bun setup，该步骤会将 MCP 安装到 Cursor 当前项目；然后运行 bun socket 启动 WebSocket 服务。安装 Figma Community 插件，或在 Figma 中选择 Plugins > Development > New Plugin > Link existing plugin，并选择 src/cursor_mcp_plugin/manifest.json。Cursor 的 MCP 配置可使用：{"mcpServers":{"TalkToFigma":{"command":"bunx","args":["cursor-talk-to-figma-mcp@latest"]}}}。仓库未说明 API 密钥或其他凭据要求。
如何使用这个 Agent？
启动 bun socket，在 Cursor 中启用 TalkToFigma MCP 服务，并在 Figma 打开文件后运行 Cursor MCP Plugin。先调用 join_channel 让插件连接 WebSocket server；随后建议调用 get_document_info 和 get_selection 确认上下文。按任务调用读取或修改工具，例如先用 scan_text_nodes 扫描文本，再用 set_multiple_text_contents 批量写入，并用 get_node_info 验证结果。进行大文件扫描时可使用分块参数；所有命令都可能抛出异常，需要由调用方处理错误。
这个 Agent 与同类方案有什么区别？
Cursor 是唯一给出完整 MCP 配置和安装流程的客户端。Claude Code 与 Codex 被描述为可集成的 AI 助手，但仓库提供的使用步骤没有说明它们的配置差异。
常见问题
是否需要 API 密钥？
可以只安装 MCP 服务器、不运行 Figma 插件吗？
join_channel 连接 WebSocket 服务，MCP 工具才能与 Figma 通信。它能修改哪些内容？
导出图片是否适合直接消费？
export_node_as_image 标为有限支持，并说明图片当前以文本形式返回 base64。