聊聊

Figma MCP + Next.js

2025 / Q2

写于北京,百度 K1 大厦

0:00/1:34

没耐心看全文?试试作为播客来收听

本文章将讨论如何利⽤ Figma MCP(Model Context Protocol)打通设计与开发⼯作流,实现从 Figma 设计稿⼀键⽣成代码,并将其集成到 Next.js 项⽬中。

"Figma MCP 的主要功能"

Figma MCP 旨在将 Figma 中的设计上下⽂信息传递给 AI 驱动的开发⼯具,从⽽实现更⾼保真度的设计到代码转换。

更多信息请参考 Figma 官⽅博客:Introducing Figma’s Dev Mode MCP server

"⼯作流设想"

以下是⼀些可以利⽤ Figma MCP 实现的⾼效⼯作流:

  • Figma + Cursor MCP: ⼀键将 UI 设计稿转换成前端代码。

  • Figma + 本地知识库 + AI + ⻜书: ⼀键⽣成 UI 设计评审报告。

  • Figma + VS Code + 本地知识库 + AI + ⻜书: ⼀键⽣成 User Study ⼤纲。

  • Figma + 本地知识库 + AI + ⻜书: ⾃动⽣成 UX Storytelling。

"⼯具选择与配置"

Figma 官⽅ MCP:(设计师推荐⽤此⽅式)

  • 优点: 功能更全⾯、官⽅⽀持。

  • 缺点: 需要将 Figma 升级到 Professional 或 Enterprise Plan。

第三⽅ MCP:

  • 有许多免费的第三⽅ Figma MCP 可供选择,但功能上可能存在差异。

  • 可以在此探索更多 MCP 服务和客户端:Explore MCP Servers and Clients

配置 Figma MCP

以 Figma 官⽅的 Dev Mode MCP 为例。

  1. 下载 Figma Desktop App。

  2. 开启 Dev Mode MCP 服务:

    1. 在 Figma 桌⾯应⽤中,点击菜单栏

    2. Plugins > Development > 勾选 Enable Dev

    3. 选择 Mode MCP Server 来启⽤服务

  3. 设置 MCP Client

    1. 在 Figma 中启⽤ MCP 服务后,需要将其配置到您的 AI ⼯具(MCP Client,Cursor、VS Code 等)中。

    2. 从教程中复制 JSON 配置代码,并将其粘贴到您的 MCP Client 的设置中。

设置 MCP Client

  1. 在 Figma 中启⽤ MCP 服务后,需要将其配置到您的 AI ⼯具(MCP Client,Cursor、VS Code 等)中。

  2. 从教程中复制 JSON 配置代码,并将其粘贴到您的 MCP Client 的设置中。

/* MCP Client */
{
  "mcpServers": {
    "Figma": {
      "url": "http://127.0.0.1:3845/sse"
    }
  }
}

MCP Client

"准备开发环境:初始化 Next.js 项⽬"

在将设计稿转换为代码之前,您需要⼀个项⽬环境来承载这些代码。Next.js 结合 Tailwind CSS 是⼀个⾮常主流且强⼤的选择,尤其适合组件化开发。

  1. 打开终端 (Terminal)。

  2. 运⾏初始化命令。该命令将创建⼀个名为 my-designsystem-app 的新项⽬,并⾃动配置好 TypeScript 和 TailwindCSS。

  3. npx create-next-app@latest .在安装过程中,它会询问⼀些问题,您可以根据⾃⼰的偏好进⾏选择(例如,建议选择使⽤ App Router )。

  4. 进⼊项⽬⽬录。

  5. 启动开发服务器。

  6. 现在,你的 Next.js 项⽬已经成功创建并运⾏起来了。这个项⽬将作为我们从 Figma ⽣成的代码的⽬标仓库。

 /* 通过 NPX 安装 Next.js 依赖项目 */
npx create-next-app@latest .

 /* 进入项目目录 */
cd --

 /* 启动本地开发服务器 */
npm run dev

"执⾏⼯作流"

配置完成后,您就可以开始执⾏从设计到代码的完整流程了。

  1. 在 Figma 中选择元素:在 Figma ⽂件中,选中你想要转换的 frame 或 layer 。它可以是⼀个独⽴的组件,也可以是⼀个完整的⻚⾯。

  2. 在 AI ⼯具中输⼊指令 (Prompt):切换到你配置好的 AI ⼯具(如 Cursor 或内置 AI 的 VS Code),输⼊具体的指令。

    1. 示例 (⽣成组件代码): "将选中的 Figma 组件转换为⼀个使⽤ React, TypeScript 和 Tailwind CSS 的函数式组件。"

  3. 集成代码到 Next.js 项⽬:

    1. 将 AI ⽣成的 React 组件代码复制出来。

    2. 在你的 Next.js 项⽬的 app/components ⽬录(如果不存在,可以新建⼀个)下创建⼀个新的 .tsx ⽂件(例如 MyNewComponent.tsx )。

    3. 将代码粘贴到这个新⽂件中。

    4. 现在你就可以在你的⻚⾯中(例如 app/page.tsx )导⼊并使⽤这个新组件了。

"最佳实践"

⽣成代码的质量取决于多种因素,⼀部分由您控制,另⼀部分则取决于您使⽤的⼯具。以下是⼀些建议,可帮助您获得更清晰、更⼀致的输出。

为您的设计意图提供最佳上下⽂,以便 MCP 和您的 AI 助⼿能够⽣成清晰、⼀致且与您的系统相符的代码。

  • 使⽤组件 (components):对任何可复⽤的元素(按钮、卡⽚、输⼊框等)使⽤组件。

  • 链接代码库:通过 Code Connect 将组件与您的代码库链接起来。这是在代码中实现⼀致组件复⽤的最佳⽅式。否则,模型只能靠猜测。

  • 使⽤变量 (variables):对间距、颜⾊、圆⻆和排版使⽤变量。

  • 语义化命名图层:例如使⽤ CardContainer ⽽不是 Group 5 。

  • 使⽤⾃动布局 (Auto layout):⽤它来传达响应式意图。

  • 提示:在⽣成代码之前,先在 Figma 中调整画框 (frame) ⼤⼩,检查其⾏为是否符合预期。

  • 使⽤注释 (annotations):使⽤注释和开发资源来传达仅从视觉上难以捕捉的设计意图,例如元素的⾏为、对⻬或响应⽅式。

“你越是放松,结果往往越好”

Built with Framer, Next.js & Tailwind

Designed by Allen Xue

© 2025

Beijing, China

20

°C