Framelink Figma MCP

让 AI 编程助手直接读取 Figma 设计数据,实现一站式设计到代码转换。

Star 数
★ 16k
最近更新
3 个月前
License
MIT
主语言
TypeScript

30 秒速览

运行形态
MCP 服务器命令行工具
可在哪里用
平台专用ChatGPT · Claude Code(不支持)
费用
软件免费,模型调用费用自付
上手难度
低 · 几分钟可跑通
开始前需要
Node.jsFigma API 密钥Shell / 命令行网络访问
典型场景
前端开发者在 Cursor 中打开 Figma 设计链接,要求 AI 实现该设计,AI 能准确生成对应框架的组件代码。
不适合
  • 不使用 Figma 作为设计源的团队
  • 需要复杂动画与交互等完整设计细节的项目

这个 Agent 能做什么,适合哪些场景?

Framelink Figma MCP 是一个基于 Model Context Protocol (MCP) 的服务器,专门为 Cursor 等 AI 编程工具提供 Figma 文件的结构化布局数据。它通过命令行工具 figma-developer-mcp 运行,需要用户提供 Figma API 密钥并进行配置。该服务器会调用 Figma API 获取文件元数据,进行简化和翻译,仅向模型提供最相关的布局和样式信息,从而提高 AI 生成代码的准确性和相关性。它支持跨平台(macOS、Linux、Windows)运行,并可通过 npx 直接启动。项目采用 MIT 许可证,源代码托管在 GitHub 上。

该服务器首先监听用户的配置指令,当 Cursor 等客户端发送包含 Figma 链接的请求时,它会调用 Figma API 获取文件、帧或组件的元数据。然后,它会对响应进行简化和翻译,过滤掉无关信息,只保留关键的布局和样式数据(如尺寸、位置、颜色、字体等)。这些简化后的数据会以文本形式返回给 AI 模型,作为生成代码的上下文。整个流程通过标准输入输出(stdio)通信,部署时通过 npx 命令启动,需要设置 --figma-api-key 参数或环境变量 FIGMA_API_KEY。

  1. 前端开发者在 Cursor 中打开 Figma 设计链接,要求 AI 实现该设计,AI 能准确生成对应框架的组件代码。
  2. 产品设计师在开发会议中,快速将设计稿转换为可运行的 React 或 Vue 原型,无需手动标注。
  3. 技术团队在迭代 UI 时,希望 AI 生成的代码与设计稿的间距、颜色等细节完全一致,减少手动调整。
  4. 独立开发者使用 Cursor 进行全栈开发,希望将 Figma 中的设计元素直接嵌入到现有代码库中。
  5. 设计系统维护者需要将设计规范的变更同步到前端代码,使用 AI 助手辅助更新样式。

如何安装或部署这个 Agent?

  1. 确保安装了 Node.js 和 npm(npx 可用)。
  2. 在 Figma 中创建个人访问令牌:登录 Figma,进入设置 → 安全 → 生成访问令牌,并复制。
  3. 在代码编辑器的 MCP 配置文件中添加以下配置:

macOS/Linux:

   {
     "mcpServers": {
       "Framelink MCP for Figma": {
         "command": "npx",
         "args": ["-y", "figma-developer-mcp", "--figma-api-key=YOUR-KEY", "--stdio"]
       }
     }
   }
   

Windows:

   {
     "mcpServers": {
       "Framelink MCP for Figma": {
         "command": "cmd",
         "args": ["/c", "npx", "-y", "figma-developer-mcp", "--figma-api-key=YOUR-KEY", "--stdio"]
       }
     }
   }
   

如何使用这个 Agent?

  1. 将上述配置保存到编辑器的 MCP 配置文件中(例如 Cursor 的 .cursor/mcp.json)。
  2. 重启编辑器,确保 MCP 服务器成功启动。
  3. 在编辑器的聊天界面中,粘贴 Figma 文件的分享链接(可以是文件、帧或组件的链接)。
  4. 输入要求,如“实现这个设计”,AI 将自动获取 Figma 数据并生成代码。
  5. 也可以设置环境变量 FIGMA_API_KEY 和 PORT 代替命令行参数。

这个 Agent 有哪些优点和局限?

优点
  • 直接从 Figma 获取布局数据,比截图更准确,AI 生成代码的保真度高。
  • 通过 MCP 标准协议,与 Cursor 等工具无缝集成,配置简单。
  • 轻量级,通过 npx 即可运行,无需额外服务。
  • 开源且采用 MIT 许可证,可自由修改和商用。
局限
  • 依赖 Figma API 和个人访问令牌,必须指定 Figma 作为设计源。
  • 主要面向 Cursor 等特定 AI 编程工具,对其他平台支持有限。
  • 运行时需要网络连接,且要求 Node.js 环境。
  • 数据经过简化处理,可能丢失某些高级设计细节,如复杂的动画或交互。

这个 Agent 与同类方案有什么区别?

目前没有在源代码中提及其他替代方案。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Framelink Figma MCP 当前 41 · 缺口较多 MCP 服务器免费 + 模型费 ★ 16k 3 个月前 TypeScript —
OSS Autopilot 83 · 表现良好 Agent 插件 / 技能免费 ★ 21 1 天前 TypeScript Claude Code · Claude.ai
Concord MCP 67 · 存在缺口 — ★ 545 今天 TypeScript Codex · Claude Code
GitMCP:任何 GitHub 项目的实时文档 MCP 服务器 47 · 缺口较多 云服务 / SaaS免费 ★ 8.5k 5 个月前 TypeScript ChatGPT · Claude Code · Claude.ai

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
41/ 100 五分制 2.1 / 5
信任安全 7/29
可靠稳定 6/14
适用触发 9/18
规范维护 9/18
有效结果 7/13
证据核验 3/8
查看各维度的扣分理由
信任安全7 / 29 · 1.2/5

证据显示:README 要求用户提供 Figma API key,并建议使用环境变量;SECURITY.md 建议限制服务器权限。但未发现用户确认机制(如工具调用前确认),数据流透明度有限(未说明数据如何被处理或发送到何处),敏感数据处理仅建议使用环境变量,未提供加密或最小化措施。依赖安全方面,有 CI 和依赖更新建议,但未提供依赖审计或漏洞扫描证据。外部影响方面,服务器会调用 Figma API 和可能发送遥测(posthog-node),但未明确说明。回滚机制未提及。来源归属方面,有明确的作者和仓库,但发布者未验证。扣分原因:缺少用户确认、数据流透明度不足、敏感数据处理不充分、依赖安全证据不足、外部影响不明确、无回滚机制。

可靠稳定6 / 14 · 2.1/5

证据显示:有测试覆盖配置解析和样式键解析,CI 包含 lint、type-check、test,表明一定的一致性。依赖可用性方面,依赖列表完整,但未提供锁定文件或依赖可用性保证。失败消息方面,未发现明确的错误处理或用户友好的失败消息。扣分原因:依赖可用性未验证,失败消息未体现。

适用触发9 / 18 · 2.5/5

证据显示:README 明确目标用户是 Cursor 用户,场景是让 AI 编码代理访问 Figma 数据。能力边界方面,README 说明服务器会简化 Figma API 响应,但未详细列出支持的工具或限制。触发精度方面,用户需粘贴 Figma 链接,但未说明如何解析或触发。环境适配方面,支持 MacOS/Linux/Windows,并提供了配置示例。扣分原因:能力边界和触发精度描述不足。

规范维护9 / 18 · 2.5/5

证据显示:README 结构清晰,包含快速开始、配置示例、演示视频。安装说明详细,支持 npx 和 env 变量。命名方面,包名和 MCP 名称稳定,但版本号未在 README 中体现。示例和 FAQ 较少,仅有快速开始。已知限制未明确列出。许可证为 MIT,清晰。版本化方面,有 release-please 工作流,但未提供 CHANGELOG。维护责任方面,有 SECURITY.md 和 CI,但未明确维护者。扣分原因:示例和 FAQ 不足,已知限制未列出,版本化信息不完整。

有效结果7 / 13 · 2.7/5

证据显示:输出可用性方面,服务器简化 Figma 数据以提供相关布局和样式信息,有助于提高 AI 准确性。边际价值方面,相比截图,提供设计数据能更准确地实现设计。成本效益方面,需要用户提供 API key,但未提供性能或成本数据。扣分原因:成本效益缺乏数据支持。

证据核验3 / 8 · 1.9/5

证据显示:README 声称能提高准确性,但未提供基准测试或用户研究。跨来源验证方面,有演示视频和文档链接,但未提供独立验证。事实与推断分离方面,README 中的声明多为断言,未区分事实和推断。扣分原因:声明缺乏证据支持,事实与推断未分离。

风险与缓解建议
  • 源码中未见:执行前用户确认开启或自行加上执行前确认;先在沙箱或测试环境跑通,确认行为后再接入真实数据。
  • 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
  • 该服务器需要 Figma API key,请确保妥善保管,避免泄露。
  • 服务器可能发送遥测数据(posthog-node),请审查其隐私政策。
  • 发布者未验证,请谨慎使用。
  • 未提供回滚机制,升级前请备份配置。
证据充分度:低 评估于 2026年8月17日 审查版本 c083d65c7e00
查看完整评分方法 →

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.13.2
    发布说明摘录
    What's New in v0.13.2 Gradients with reduced opacity render at the right strength Previously, gradient fills ignored *layer* opacity, only looking at paint/stop-level opacity. Agents could generate gradient overlays like scrims much stronger than intended. Solid fills already honored opacity; now gradients do too. - [#399](https://github.com/GLips/Figma-Context-MCP/pull/399) · authored by @LovePlayCode --- <details> <summary><strong>Full technical changelog</strong></summary> [0.13.2](https://github.com/GLips/Figma-Context-MCP/compare/v0.13.1...v0.13.2) (2026-06-18) …
    在 GitHub 查看 ↗
  2. v0.13.1
    发布说明摘录
    What's New in v0.13.1 A quick follow-up to v0.13.0's payload diet. No more irrelevant, duplicate, or misleading titles Figma auto-names a text layer after its content, so a layer that reads "Add to cart" is *named* "Add to cart" too. The design data was carrying both. Worse, when someone edited the copy without renaming the layer, the stale old name often rode along, contradicting the real text and confusing LLM consumers. Additionally, auto-named labels (Rectangle 12, Frame 8372211, Ellipse 6) were included. All are gone now. …
    在 GitHub 查看 ↗
  3. v0.13.0
    发布说明摘录
    What's New in v0.13.0 v0.13.0 is focused on design output quality: new support for Figma grid layouts, a batch of rendering bug fixes, and — perhaps most importantly — a new default output format that cuts token usage roughly in half. Two of these changes came from the community: thanks to [@Jkuzz](https://github.com/Jkuzz) and [@cnYui](https://github.com/cnYui). Your payloads just got cut in half …
    在 GitHub 查看 ↗

常见问题

如何获取 Figma API 密钥?
在 Figma 中进入设置 → 安全 → 生成个人访问令牌,并妥善保存。
是否支持其他 AI 编程工具?
本项目明确为 Cursor 设计,但理论上支持任何支持 MCP 协议的客户端,需要客户端的 MCP 配置。
使用该服务器需要付费吗?
该服务器本身是开源的,但需要 Figma 账户和 API 密钥。Figma 的 API 使用可能受其服务条款和配额限制。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents