这个项目能做什么

TalkToFigma 在 AI 智能体(Cursor、Claude Code、Codex)与 Figma 之间实现了一个模型上下文协议(MCP)桥接。通过一个 WebSocket 服务器和一个配套的 Figma 插件,智能体可以检查文档和选区,创建和编辑节点,管理文本、自动布局、样式、组件和注释,并将节点导出为图像。 架构 - src/talk_to_figma_mcp:TypeScript MCP 服务器,将 Figma 操作暴露为工具。 - src/cursor_mcp_plugin:与智能体侧通信的 Figma 插件。 - src/socket.ts:在 MCP 服务器与插件之间中继消息的 WebSocket 服务器。 设置 安装 Bun,运行 `bun setup`(这也会在当前 Cursor 项目中注册 MCP 服务器),使用 `bun socket` 启动 socket,然后从社区页面安装 Figma 插件,或通过 manifest.json 在本地链接它。手动 MCP 配置在 ~/.cursor/mcp.json 中使用 `bunx cursor-talk-to-figma-mcp@latest`。Windows + WSL 指南提到在 socket.ts 中取消注释主机名 0.0.0.0。 使用流程 启动 WebSocket 服务器,安装 MCP 服务器,打开 Figma 并运行插件,使用 `join_channel` 加入频道,然后从智能体发出命令。最佳实践包括先加入频道,在编辑前读取文档信息和选区,使用 get_node_info 进行验证,并对大型设计使用批量操作。 工具覆盖范围 - 文档和选区:get_document_info、get_selection、read_my_design、get_node_info、get_nodes_info、set_focus、set_selections。 - 注释:get_annotations、set_annotation、set_multiple_annotations、scan_nodes_by_types。 - 原型设计:get_reactions、set_default_connector、create_connections(用于 FigJam 连接线)。 - 创建:create_rectangle、create_frame、create_section、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、set_image_fill。 - 组织:move_node、resize_node、delete_node、delete_multiple_nodes、clone_node、rename_node、set_parent。 - 组件和样式: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。 提示词 辅助提示词可指导复杂任务:design_strategy、read_design_strategy、text_replacement_strategy、annotation_conversion_strategy、swap_overrides_instances、reaction_to_connector_strategy。 值得注意的贡献功能包括批量文本替换和实例覆盖传播。采用 MIT 许可证。