---

name: figma-automation description: "通过 Rube MCP (Composio) 自动化 Figma 任务：文件、组件、设计令牌、评论、导出。始终先搜索工具获取当前 Schema。" risk: safe source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Figma 自动化

通过 Composio 的 Figma 工具包经由 Rube MCP 自动化 Figma 操作。

前提条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit figma 建立活跃的 Figma 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具 Schema

设置

获取 Rube MCP: 在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥 — 只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 响应来验证 Rube MCP 可用
2. 使用 toolkit figma 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是 ACTIVE，按返回的认证链接完成 Figma 认证
4. 确认连接状态显示 ACTIVE 后再运行任何工作流

核心工作流

1. 获取文件数据和组件

何时使用: 用户想要检查 Figma 设计文件或提取组件信息

工具序列:

1. FIGMA_DISCOVER_FIGMA_RESOURCES - 从 Figma URL 提取 ID [前提]
2. FIGMA_GET_FILE_JSON - 获取文件数据（默认简化）[必需]
3. FIGMA_GET_FILE_NODES - 获取特定节点数据 [可选]
4. FIGMA_GET_FILE_COMPONENTS - 列出已发布组件 [可选]
5. FIGMA_GET_FILE_COMPONENT_SETS - 列出组件集 [可选]

关键参数:

• file_key: URL 中的文件密钥（如 figma.com/design/abc123XYZ/... 中的 'abc123XYZ'）
• ids: 逗号分隔的节点 ID（不是数组）
• depth: 树遍历深度（2 表示页面和顶层子元素）
• simplify: True 表示 AI 友好格式（减少 70%+ 大小）

注意事项:

• 仅支持设计文件；FigJam 白板和幻灯片返回 400 错误
• ids 必须是逗号分隔的字符串，不是数组
• URL 中节点 ID 可能是短横线格式（1-541），但 API 需要冒号格式（1:541）
• 宽泛的 ids/depth 可能触发超大载荷（413）；缩小范围或减少深度
• 响应数据可能在 data_preview 而非 data 中

2. 导出和渲染图片

何时使用: 用户想要将设计资产导出为图片

工具序列:

1. FIGMA_GET_FILE_JSON - 查找要导出的节点 ID [前提]
2. FIGMA_RENDER_IMAGES_OF_FILE_NODES - 将节点渲染为图片 [必需]
3. FIGMA_DOWNLOAD_FIGMA_IMAGES - 下载渲染的图片 [可选]
4. FIGMA_GET_IMAGE_FILLS - 获取图片填充 URL [可选]

关键参数:

• file_key: 文件密钥
• ids: 逗号分隔的要渲染的节点 ID
• format: 'png'、'svg'、'jpg' 或 'pdf'
• scale: PNG/JPG 的缩放因子（0.01-4.0）
• images: {node_id, file_name, format} 数组用于下载

注意事项:

• 图片以 node_id 到 URL 的映射返回；某些 ID 可能为 null（渲染失败）
• URL 是临时的（有效期约 30 天）
• 图片上限为 3200 万像素；更大的请求会自动缩小

3. 提取设计令牌

何时使用: 用户想要提取设计令牌用于开发

工具序列:

1. FIGMA_EXTRACT_DESIGN_TOKENS - 提取颜色、排版、间距 [必需]
2. FIGMA_DESIGN_TOKENS_TO_TAILWIND - 转换为 Tailwind 配置 [可选]

关键参数:

• file_key: 文件密钥
• include_local_styles: 包含本地样式（默认 true）
• include_variables: 包含 Figma 变量
• tokens: 提取的完整令牌对象（用于 Tailwind 转换）

注意事项:

• Tailwind 转换需要完整的令牌对象，包括 total_tokens 和 sources
• 传递给转换前不要从提取响应中剥离字段

4. 管理评论和版本

何时使用: 用户想要查看或添加评论，或检查版本历史

工具序列:

1. FIGMA_GET_COMMENTS_IN_A_FILE - 列出所有文件评论 [可选]
2. FIGMA_ADD_A_COMMENT_TO_A_FILE - 添加评论 [可选]
3. FIGMA_GET_REACTIONS_FOR_A_COMMENT - 获取评论反应 [可选]
4. FIGMA_GET_VERSIONS_OF_A_FILE - 获取版本历史 [可选]

关键参数:

• file_key: 文件密钥
• as_md: 以 Markdown 格式返回评论
• message: 评论文本
• comment_id: 用于反应的评论 ID

注意事项:

• 评论可以使用 client_meta 定位到特定节点
• 回复评论不能嵌套（只有一层回复）

5. 浏览项目和团队

何时使用: 用户想要列出团队项目或文件

工具序列:

1. FIGMA_GET_PROJECTS_IN_A_TEAM - 列出团队项目 [可选]
2. FIGMA_GET_FILES_IN_A_PROJECT - 列出项目文件 [可选]
3. FIGMA_GET_TEAM_STYLES - 列出团队已发布样式 [可选]

关键参数:

• team_id: URL 中的团队 ID（figma.com/files/team/TEAM_ID/...）
• project_id: 项目 ID

注意事项:

• 团队 ID 无法通过编程获取；从 Figma URL 提取
• 只返回已发布的样式/组件