SuperAPI AI 工具集

figma-automation

设计与创作

查看项目

更新于 10-16 08:35

技能介绍

用途:通过 Composio 的 Figma 工具包,经由 Rube MCP 自动化 Figma 任务,如读取设计文件、导出资源、提取设计令牌、管理评论与版本、浏览团队项目。

前提:需先连接 Rube MCP(确认 RUBE_SEARCH_TOOLS 可用),并通过 RUBE_MANAGE_CONNECTIONS 激活 figma 工具包连接,状态为 ACTIVE 后方可运行工作流。设置时将 https://rube.app/mcp 添加为 MCP 服务器端即可,无需 API 密钥。始终先调用 RUBE_SEARCH_TOOLS 获取当前工具结构。

主要能力:

  1. 获取文件与组件:FIGMA_DISCOVER_FIGMA_RESOURCES 解析 URL 提取 ID;FIGMA_GET_FILE_JSON 获取文件数据(默认简化,约减少 70% 体积);FIGMA_GET_FILE_NODES 获取节点;FIGMA_GET_FILE_COMPONENTS 与 FIGMA_GET_FILE_COMPONENT_SETS 列出组件与组件集。参数 file_key 取自 URL,ids 为逗号分隔字符串(非数组),depth 控制遍历深度,simplify 启用 AI 友好格式。
  2. 导出与渲染图像:FIGMA_RENDER_IMAGES_OF_FILE_NODES 渲染节点为 png、svg、jpg 或 pdf,scale 支持 0.01-4.0(仅 png/jpg);FIGMA_DOWNLOAD_FIGMA_IMAGES 下载,FIGMA_GET_IMAGE_FILLS 获取图像填充 URL。图像以 node_id 到 URL 映射返回,部分可能为 null,URL 约 30 天有效,图像上限 32 百万像素,超出自动缩小。
  3. 提取设计令牌:FIGMA_EXTRACT_DESIGN_TOKENS 提取颜色、排版、间距,可选 include_local_styles 与 include_variables;FIGMA_DESIGN_TOKENS_TO_TAILWIND 转换为 Tailwind 配置,转换需完整 tokens 对象(含 total_tokens 与 sources),不可删减字段。
  4. 评论与版本:FIGMA_GET_COMMENTS_IN_A_FILE、FIGMA_ADD_A_COMMENT_TO_A_FILE、FIGMA_GET_REACTIONS_FOR_A_COMMENT、FIGMA_GET_VERSIONS_OF_A_FILE。评论可用 as_md 返回 Markdown,可用 client_meta 定位节点,回复评论仅一层不可嵌套。
  5. 项目与团队:FIGMA_GET_PROJECTS_IN_A_TEAM、FIGMA_GET_FILES_IN_A_PROJECT、FIGMA_GET_TEAM_STYLES,仅返回已发布的样式与组件,团队 ID 需从 URL 手动提取。

限制:GET_FILE_JSON 仅支持 Design 文件(figma.com/design/ 或 figma.com/file/),FigJam 看板与 Slides 会返回 400 错误。节点 ID 在 URL 中为短横线格式(如 1-541),API 需冒号格式(如 1:541)。ids 必须以逗号分隔字符串传入。过宽的 ids 或过大的 depth 可能触发 413 超大载荷,应缩小范围或降低深度。响应数据可能位于 data_preview 而非 data。渲染失败时对应 ID 返回 null。团队 ID 无法程序化获取,需从 Figma URL 提取。

常见模式:先用 FIGMA_DISCOVER_FIGMA_RESOURCES 解析 URL 提取 file_key、node_id、team_id 并转换节点 ID 格式;再以 depth=2 获取概览,定位目标节点后用具体 ids 与更高 depth 获取细节。