设计系统自动化:claude-talk-to-figma-mcp组件实例、变体与样式创建完整教程
设计系统自动化:claude-talk-to-figma-mcp组件实例、变体与样式创建完整教程
claude-talk-to-figma-mcp 是一个基于 Model Context Protocol(MCP)的开源项目,让 Claude Desktop、Claude Code、Cursor 等 AI 工具能够直接读取、分析和修改 Figma 设计。本教程聚焦设计系统自动化:如何用自然语言批量创建组件实例、组件变体(Component Set)和可复用样式(文本/颜色/效果样式),几分钟就能把手工重复的设计系统工作交给 AI 完成。
为什么需要设计系统自动化
手动维护设计系统最耗时的三件事:批量放置组件实例、切换组件变体、创建并统一样式。用 claude-talk-to-figma-mcp 后,这些操作变成一句自然语言指令:
"把文档里所有 Primary 按钮替换为组件库中的按钮实例,Hover 状态的变体自动应用阴影效果"
它还能批量更新样式、审计组件使用、生成设计标注,且支持任意 Figma 账号(包括免费版),无需 Dev Mode 许可证。
快速上手:5 分钟配置 MCP 环境
第一步:启动 WebSocket 服务器
在终端中运行(会自动克隆、安装并启动服务):
npx claude-talk-to-figma-mcp
第二步:在 Figma 中导入插件
打开 Figma 桌面端,进入 Menu → Plugins → Development → Import plugin from manifest,选择 MCP 安装目录下的 manifest.json,点击导入。
第三步:连接 Channel
打开 Figma 插件,点击 Connect 后复制绿色框中的 Channel ID,在 AI 对话框中输入:
Connect to Figma, channel {你的Channel ID}
第四步:配置 AI 客户端(以 Cursor 为例)
在 Cursor 的 Settings → Tools & Integrations 中点击 New MCP Server,添加服务器配置并保存重启即可。
配置成功后,Cursor 的 MCP Tools 列表中会出现 ClaudeTalkToFigma 条目,状态显示"39 tools enabled",说明读取与修改类工具全部就绪。
组件实例创建:从节点到可复用组件
组件相关能力集中在 component-tools.ts,常用工具有三个:
| 工具 | 作用 | 典型提示词 |
|---|---|---|
create_component_from_node |
把现有 Frame/Group 转成可复用组件 | "把选中的按钮转成名为 Button/Primary 的组件" |
create_component_instance |
在指定位置创建组件实例 | "在画板顶部按 8pt 间距创建 5 个该组件实例" |
set_instance_variant |
修改实例变体属性(保留覆盖内容) | "把这个实例切到 Hover 变体" |
推荐工作流:
- 让 AI 先用
get_local_components列出文档中已有组件,确认componentKey; - 用
create_component_from_node把设计稿中的元素"组件化"; - 用
create_component_instance按坐标批量铺实例; - 需要差异化时,用
set_instance_variant原地切换变体——它会保留实例上的文字、图片等覆盖修改,比"删除再新建"高效得多。
💡 提示:所有创建类命令都需要显式传入
parentId参数,可先用get_pages工具获取目标页面的节点 ID。
组件变体自动化:一句话生成 Component Set
Figma 的变体机制(Component Set)是设计系统的核心,但手动整理变体属性非常繁琐。claude-talk-to-figma-mcp 提供了两个关键工具(见 component-tools.ts):
create_component_set:把多个已存在的组件节点合并成一个 Component Set,并自动统计变体数量;set_reactions:为组件变体添加交互,例如在默认变体上设置 "While hovering → Change to hover variant",让 Hover/Pressed 变体真正"动起来"。
试试这条组合提示词:
"把按钮的 Default、Hover、Disabled 三个组件合并为一个 Component Set,命名为 Button,并给 Default 变体添加鼠标悬停切换到 Hover 变体的交互"
AI 会自动完成合并、命名和反应设置,全程无需打开 Figma 操作面板。
可复用样式一键创建:文本、颜色与效果
样式创建工具位于 style-tools.ts,覆盖设计系统中最常用的三类本地样式:
文本样式(Typography)
create_text_style 支持字体族、字重、字号、字距、行高、大小写等完整排版参数:
"创建三个文本样式:Heading/H1(Inter Bold 32px)、Body/Large(Inter Regular 18px,行高 24px)、Caption(Inter Regular 12px)"
颜色样式(Paint Style)
create_paint_style 用 0–1 的 RGBA 值创建颜色样式,推荐配合命名规范(如 Brand/Primary、UI/Background)批量建立色板:
"按品牌色板创建颜色样式:Brand/Primary(#E63946)、UI/Background(#FAFAFA)、UI/Text(#1A1A1A)"
效果样式(Effect Style)
create_effect_style 支持 DROP_SHADOW、INNER_SHADOW、LAYER_BLUR 等效果,适合沉淀阴影规范:
"创建阴影样式 Shadow/Medium:向下偏移 4px、模糊半径 8px、黑色 15% 透明度"
创建完成后,这些样式会出现在 Figma 的本地样式库中,后续用 set_text_style_id、set_effect_style_id 等工具即可应用到任意节点,形成"建一次、处处用"的闭环。
进阶:用 Figma Variables 沉淀设计令牌
如果团队已经在用 Figma Variables(设计令牌),variable-tools.ts 提供了完整支持:
get_variables:列出文件中的所有变量集合、模式与变量;set_variable:创建或更新 COLOR / FLOAT / STRING / BOOLEAN 类型变量;apply_variable_to_node:把变量绑定到节点,实现深浅模式一键切换。
示例提示词:"创建变量集合 DesignTokens,加入 primary(#E63946)和 radius-md(8px)两个变量,并把 primary 应用到所有 Primary 按钮"。
实用提示词清单
| 场景 | 提示词示例 |
|---|---|
| 审计现状 | "列出文档中所有本地组件和样式,检查命名是否符合 Brand/Component 规范" |
| 批量组件化 | "把页面里的 6 个图标 Frame 各自转成组件,统一命名 Icon/xxx" |
| 变体维护 | "把所有按钮实例统一切换为大尺寸变体,保留各自文字内容" |
| 样式统一 | "把全文 16px 灰色正文文字统一应用 Body/Regular 文本样式" |
| 令牌同步 | "读取 DesignTokens 变量集合,把所有硬编码为主色 #FF6B6B 的填充替换为变量引用" |
更多完整命令参考 COMMANDS.md,提示词技巧见其中 "Effective prompt examples" 章节。
常见问题排查
- 连接失败:确认 WebSocket 服务器在运行、Figma 插件端口为 3055,且 Channel ID 与 AI 端一致;详见 TROUBLESHOOTING.md。
- 创建命令报 parentId 错误:多 Agent 并行模式下禁止依赖隐式页面上下文,必须显式传
parentId(页面 ID 可通过get_pages获取)。 - 变体切换后样式丢失? 检查组件 Set 的属性名是否与
properties键值完全一致。
相关文档
- 完整安装指南:INSTALLATION.md
- 测试规范:TESTING.md
- 工具实现入口:tools/index.ts
- MCP 服务器主文件:server.ts
掌握以上四个环节——组件实例、变体、样式、变量——你已可以用一句话驱动 AI 完成过去需要数小时的设计系统维护工作。建议从一个小型文档开始练习,逐步建立属于自己团队的"自然语言设计系统工作流"。



