cqbase.net · 中英双语

CQBase 上下文库

Context & Query Base

MCP

Figma Context MCP

把 Figma 的布局信息提供给 Cursor 等编码代理的 MCP 服务器。

GLips/Figma-Context-MCP 是 MIT 许可的 MCP 服务器,用来把 Figma 的布局信息交给 Cursor 一类编码代理,让实现更接近设计稿,而不是只凭截图猜测间距。

只授权代理需要的文件,不要把整个团队的 Figma 访问令牌范围开到最大。设计稿可能含未发布产品,注意仓库和对话记录不要把文件内容完整存下来。

推荐来源:

  • @HermesWatcher 在 2026 年 10 月 27 日 的帖子里提到了这个项目(数字采集于 2026 年 11 月 15 日:1149 次喜欢,126 次转发)。
  • @stewy0x 在 2026 年 11 月 14 日 的帖子里提到了这个项目(数字采集于 2026 年 11 月 15 日:52 次喜欢,7 次转发)。

本页是导读,不是原文。

解决什么问题

Figma Context MCP(仓库 GLips/Figma-Context-MCP,npm 包名 figma-developer-mcp,产品名 Framelink MCP for Figma)把 Figma 文件里的布局和样式信息交给编码代理,而不是只靠截图去猜间距。它会先简化 Figma API 返回的数据,再交给模型。

官方工具只有两个:get_figma_data 读取设计结构,download_figma_images 把图片资源下载到项目目录。代理通常是在你粘贴 Figma 链接之后才调用它们。

适合谁

适合在 Cursor、Claude Code、Claude Desktop、VS Code 或其他 MCP 客户端里,按设计稿实现界面的人。它使用 MIT 许可。使用前需要一份 Figma 个人访问令牌。

令牌绑定的是你的 Figma 账号,可以读取该账号能打开的文件。请只给当前任务需要的文件授权,不要把团队范围、权限开到最大的令牌随便发给代理。设计稿里可能有未发布产品,不要把整份文件贴进仓库或长期对话记录。

怎么装

核验日期为 2026-11-15(Asia/Shanghai)。命令来自仓库 README 和 Framelink Quickstart。

先在 Figma 中创建个人访问令牌:账号设置 → Security → Personal access tokens。官方说明,按默认选项生成的令牌往往没有 MCP 所需范围。Quickstart 列出了一组应勾选的范围;Authentication 则写明,严格来说至少需要 file_content:read,若出现相关 403,还应加上 file_dev_resources:read。令牌只显示一次,不要写入公开仓库。

macOS / Linux 上,多数客户端可用这份配置(把 YOUR-KEY 换成令牌):

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

Windows 上,官方提醒 npx 是批处理文件,多数 MCP 客户端不能直接启动,应改用 cmd:

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

也可以改用环境变量 FIGMA_API_KEY,而不把令牌写在参数里。

Claude Code

claude mcp add Framelink_Figma_MCP -- npx -y figma-developer-mcp --figma-api-key=YOUR-KEY --stdio

Cursor

打开 Settings → Cursor Settings → MCP → Add new global MCP server,或把上面的 JSON 写入 ~/.cursor/mcp.json;只需对单个项目生效时,可在项目里放 .cursor/mcp.json。

Claude Desktop

打开 Settings → Developer,编辑 claude_desktop_config.json,写入与上面相同的 mcpServers 配置(Windows 仍按官方 Windows 示例使用 cmd)。若本机用 NVM 等工具管理 Node,排障文档还介绍过 Claude Desktop 用错 Node 版本的情况。

一个实际例子

下面的提示词是为本文写的核验步骤,不是官方固定口令。本次没有实跑,因此不编造页面结构或生成代码。

  1. 完成安装,在客户端确认能看到 get_figma_data。
  2. 在 Figma 里对单个 frame 或 group 右键,选择 Copy/Paste as → Copy link to selection。官方建议一次只做一节,完整文件容易超出模型上下文。
  3. 把链接贴进对话,发送:Implement this Figma frame. First call get_figma_data; do not invent spacing from a screenshot.
  4. 按官方工具说明,代理应使用你提供的链接调用 get_figma_data。请自己对照设计稿检查间距、字体和颜色,不要把一次生成的结果当成已经核对过的产出。

常见坑

  • 令牌范围不够,出现 403 且正文含 Invalid scope(s)。这是官方排障页写明的原因:默认生成的 PAT 常常缺少 file_content:read 等范围。应按 Quickstart 重新生成令牌,而不是反复重试同一个令牌。
  • 触发 Figma API 限流(429)。官方写明限流来自 Figma,而不是这个 MCP 自己:免费方案大约每月 6 次请求;付费方案(含 Dev Seat)在其使用的接口上起跳为每分钟 10 次。限流还受文件所有者套餐影响。详见 Troubleshooting 和 Figma 的 Rate Limit 文档。
  • Cannot find module。官方建议先关闭客户端,运行 npx clear-npx-cache,再重新打开。
  • 下载图片时路径被拒绝。工具只能写到 --image-dir 指定的目录(默认是服务器启动目录)。许多客户端启动服务器时的工作目录并不是你的项目根目录,需要显式设置 --image-dir。
  • 在 Windows 上直接把 npx 当作 command。请改用官方的 cmd /c npx ... 写法。

FAQ

必须用个人访问令牌吗?

这是官方推荐给大多数人的方式。服务器也可以使用你已经通过 Figma OAuth 应用拿到的访问令牌,但它不会帮你走授权流程,也不会自动刷新;过期后请求会失败,直到你提供新令牌。HTTP 模式下还可以按请求附带令牌。stdio 模式必须在启动时提供令牌。

免费 Figma 账号够用吗?

可以创建令牌并调用 API,但免费方案的速率限制非常紧。官方排障页写的是大约每月 6 次请求。若你频繁读取设计稿,需要对照 Figma 当前的套餐说明,而不是假设可以随意刷新。

为什么连接成功,调用工具却返回 403?

先看错误正文里的 err 字段。官方把 Invalid scope(s)、Invalid token、Token expired 和 File not exportable 分开处理。文件还必须属于该令牌对应的账号,或已明确共享给它。issue #358 也报告过客户端显示已连接、工具调用仍返回 403 的情况(该 issue 已关闭)。

一次实现整页设计可以吗?

可以尝试,但官方 Quickstart 建议一次只做一节,复杂设计仍可能让模型上下文不够用。更稳妥的做法是复制单个 frame 的链接,而不是整份文件的链接。

令牌要不要写进参数?

--figma-api-key 和 FIGMA_API_KEY 都是官方支持的方式。把令牌写进用户级配置时,注意不要提交到 Git。HTTP 共享部署更适合按请求传递令牌,避免多人共用同一份服务账号令牌。

来源与许可

仓库 GLips/Figma-Context-MCP 使用 MIT 许可。本文依据 2026-11-15 查阅的 README、Quickstart、Authentication、Tools 和 Troubleshooting,用自己的话写成,供 CQBase 上下文库使用。若安装命令或令牌范围有变,以这些官方材料为准。

订阅 CQBase 周刊

每周一封,介绍本周新收录的公开 AI 技能、提示词、MCP 和用法。可随时退订。我们不会把邮箱交给第三方作其营销之用。