MCP 教程:将 Figma 设计稿转化为前端代码
Model Context Protocol (MCP) 是 Anthropic 提出的开放协议标准,用于让大语言模型(LLM)与外部工具/数据源标准化交互,已被 Figma 官方支持,并广泛应用于 Cursor、Trae IDE、Claude Code、VS Code 等 AI 编程工具中。
通过 MCP,AI 可以直接访问 Figma 设计稿的结构化数据(图层、组件、样式、变量、布局等),而非仅靠截图猜测,从而实现高保真地将设计稿转化为前端代码(如 HTML + Tailwind CSS、React 等)。这大大提升了还原度,减少手动调整。
本教程基于 2026 年最新实践,结合官方 Figma MCP 和主流工具(如 Trae IDE 与 Cursor),手把手教你实现设计到代码的自动化。
前置准备
- Figma 账号:需有设计稿访问权限(推荐 Professional 或更高计划以启用 Dev Mode)。
- 获取 Figma Personal Access Token:
- 登录 Figma → Settings → Personal access tokens → New token(只需读取权限)。
- 复制 Token,妥善保存。
- 设计稿最佳实践(提升还原度):
- 使用组件(Components)复用元素。
- 定义变量(Variables)管理颜色、间距、字体。
- 图层命名语义化(避免 Group 1)。
- 使用 Auto Layout。
- 标注响应式约束。
方法一:使用 Trae IDE(推荐中文开发者,字节出品,对标 Cursor)
Trae IDE 深度集成 MCP,尤其适合国内用户,通过 MCP Server – Figma AI Bridge 一键转换。
步骤
- 下载安装 Trae IDE
官网:https://trae.cn 下载最新版安装。 - 集成 Figma AI Bridge MCP Server
- 打开 Trae IDE → 工具 → MCP 市场。
- 搜索 “Figma AI Bridge” → 安装并立即使用。
- 输入你的 Figma Personal Access Token 配置。
- 创建项目并开启对话
- 新建空文件夹,在 Trae 中打开。
- 打开 AI 对话(默认使用 Builder with MCP 或 Figma 助手智能体)。
- 选择模型(如 DeepSeek-V3)。
- 复制 Figma 链接
- 在 Figma 中选中目标 Frame/页面 → 右键 → Copy link to selection(获取带 node-id 的链接)。
- 提示 AI 生成代码
- 在对话框粘贴链接,并输入提示:
根据以下 Figma 链接,精准还原 UI 设计,生成响应式 HTML + Tailwind CSS 代码。 代码结构清晰,视觉细节高度一致,禁止修改设计内容。 生成 index.html 并支持浏览器预览。 Figma 链接:{你的链接} - AI 会自动调用 MCP 工具读取设计稿、下载资源,生成代码文件。
- 预览与迭代
- 生成后,双击 index.html 预览。
- 如需优化,继续对话:“将布局改为网格” 或 “添加暗黑模式”。
优势:无需本地服务器,配置简单,生成速度快,支持多页面。
方法二:使用 Cursor(国际主流,灵活强大)
Cursor 支持官方/社区 MCP Server。
步骤(官方 Figma MCP)
- 启用 Figma Dev Mode MCP Server
- 更新 Figma Desktop App 至最新。
- 打开设计稿 → Dev Mode(Shift + D) → Inspect 面板 → Enable desktop MCP server。
- 在 Cursor 中配置
- Cursor → Settings → Features → MCP Servers → Add new。
- 添加 Figma 官方远程服务器:https://mcp.figma.com/mcp(或本地端口)。
步骤(社区 Figma-Context-MCP,推荐更高还原度)
- 安装社区 Server
git clone https://github.com/GLips/Figma-Context-MCP.git
cd Figma-Context-MCP
pnpm install
# 配置 .env 中的 FIGMA_API_KEY = 你的 Token
pnpm dev # 运行在本地端口(如 3333)
- Cursor 配置本地 Server
- MCP Servers → Add new → URL: http://localhost:3333/sse
- 生成代码
- 打开 Composer(Cmd + I)。
- 粘贴 Figma 选中链接,或直接描述:
使用提供的 Figma 设计稿,生成 React + Tailwind CSS 代码。 高保真还原布局、颜色、间距。 Figma 链接:{链接} - AI 会调用 get_figma_data / download_images 工具,生成代码。
优势:支持 React/Vue 等框架,社区优化更精准。
进阶技巧
- 指定框架:提示中添加 “使用 React + Shadcn UI” 或 “Vue 3”。
- 多页面批量:一次喂多个链接,生成完整项目结构。
- 结合 Code Connect:在 Figma 中映射组件到你的代码库,进一步提升一致性。
- 常见问题解决:
- 还原不准 → 检查设计稿规范 + 缩小范围(单 Frame)。
- Token 无效 → 重新生成,确保权限。
- 上下文过长 → 分步生成(先布局,后交互)。
总结
MCP 已彻底改变设计交付流程:从手动切图测量,到 AI 一键高保真转换,效率提升 5-10 倍。推荐从 Trae IDE 起步(简单上手),熟练后切换 Cursor 追求极致灵活。
准备好你的 Figma 设计稿,现在就试试吧!生成后如需进一步优化(如添加交互逻辑),继续与 AI 对话即可。
有具体设计稿链接或遇到问题,欢迎贴出来继续讨论~