适合谁
- 使用 Cursor、Claude Code 或 Codex，并希望以自然语言驱动 Figma 操作的设计和开发团队
- 需要批量处理文本、布局、批注或组件实例的 Figma 工作流
- 能够运行 Bun、WebSocket 服务器并安装 Figma 插件的用户
T
47FMRS · D
MIT 许可的社区 MCP 项目，通过 MCP 服务器、Figma 插件和 WebSocket 连接 AI agent 与 Figma。README 明确列出丰富的读取、创建、修改、批处理、批注、组件、连接和导出工具；使用前应准备 Bun、Figma 插件和本地 WebSocket 服务，并谨慎执行删除和批量修改。
TalkToFigma 是一个由 grab 维护的开源 MCP 集成，将 AI agent 与 Figma 连接起来，用于读取设计信息并以编程方式修改设计。它包含 TypeScript MCP 服务器、Figma 插件和用于两者通信的 WebSocket 服务器。
工具能力
get_document_info
获取当前 Figma 文档信息
get_selection
获取当前选区信息
read_my_design
在无参数情况下读取当前选区的详细节点信息
get_node_info
获取指定节点的详细信息
get_nodes_info
批量获取多个节点的详细信息
set_focus
选中指定节点并滚动视口至该节点
set_selections
选中多个节点并滚动视口显示它们
get_annotations
获取当前文档或指定节点的全部批注
set_annotation
创建或更新支持 Markdown 的批注
set_multiple_annotations
批量创建或更新批注
scan_nodes_by_types
按节点类型扫描节点
get_reactions
获取节点的原型交互，并显示视觉高亮动画
set_default_connector
设置创建连接时使用的默认 FigJam 连接线样式
create_connections
根据原型流程或自定义映射创建 FigJam 连接线
create_rectangle
创建矩形
create_frame
创建图框
create_text
创建可自定义字体属性的文本节点
scan_text_nodes
扫描文本节点，并为大型设计提供智能分块
set_text_content
设置单个文本节点的内容
set_multiple_text_contents
批量更新多个文本节点的内容
set_layout_mode
设置图框的布局模式和换行行为
set_padding
设置自动布局图框的内边距
set_axis_align
设置自动布局图框的主轴和交叉轴对齐方式
set_layout_sizing
设置自动布局图框的水平和垂直尺寸模式
set_item_spacing
设置自动布局子项之间的距离
set_fill_color
设置节点填充颜色
set_stroke_color
设置节点描边颜色和粗细
set_corner_radius
设置节点圆角，可分别控制各个角
move_node
移动节点
resize_node
调整节点尺寸
delete_node
删除节点
delete_multiple_nodes
批量删除节点
clone_node
复制节点，可设置位置偏移
get_styles
获取本地样式信息
get_local_components
获取本地组件信息
create_component_instance
创建组件实例
get_instance_overrides
提取选定组件实例的覆盖属性
set_instance_overrides
将已提取的覆盖属性应用到目标实例
export_node_as_image
将节点导出为 PNG、JPG、SVG 或 PDF；图像目前支持有限并以文本形式返回 base64
join_channel
加入用于与 Figma 通信的指定频道
安装接入
安装 Bun；运行 bun setup 完成设置并将 MCP 安装到 Cursor 当前项目；运行 bun socket 启动 WebSocket 服务器；从 Figma Community 安装插件，或在 Figma 中通过 Plugins > Development > New Plugin > Link existing plugin，选择 src/cursor_mcp_plugin/manifest.json；打开插件并使用 join_channel 加入频道。
claude_desktop_config.json
{"mcpServers":{"TalkToFigma":{"command":"bunx","args":["cursor-talk-to-figma-mcp@latest"]}}}
选型与风险
不适合谁
- 只需要静态读取文件而不运行 Figma 插件的场景
- 不希望 AI 修改 Figma 文档的只读审阅场景
- 需要已明确支持的远程托管、身份认证或其他传输方式的场景
所需权限
- 需要在 Figma 中运行配套开发插件
- 需要 MCP 服务器与 Figma 插件之间的本地 WebSocket 通信
- 执行修改工具时需要对当前 Figma 文档进行相应的读写操作；具体权限范围取决于所调用的工具
风险与副作用
- delete_node 和 delete_multiple_nodes 会删除节点，修改前应确认目标并验证结果
- 批量文本、布局、样式和组件覆盖操作可能影响多个设计元素
- WebSocket 频道连接错误可能导致无法与 Figma 通信
- 节点图像导出目前支持有限，且返回 base64 文本
常见排障
- 确认已安装 Bun，并先运行 bun setup
- 确认 WebSocket 服务器已通过 bun socket 启动
- 确认 Figma 插件已安装、打开并加入了正确频道
- 确认 Cursor MCP 配置中的命令为 bunx，且服务器路径或包配置正确
- Windows + WSL 场景下，按 README 检查 src/socket.ts 中的 0.0.0.0 主机名设置
- 大型设计扫描文本时使用 scan_text_nodes 的分块参数并关注 WebSocket 更新
使用场景
读取当前 Figma 文档、选区和节点信息
批量替换设计中的文本内容
创建和修改图框、矩形、文本及布局属性
管理批注、组件实例覆盖和原型连接
将节点导出为图像格式
支持客户端
Cursor完整支持
Claude Code部分支持
Codex部分支持