southleft/figma-console-mcp

项目介绍

Figma Console MCP 是一个 Model Context Protocol 服务器，让 Claude、Cursor、Windsurf 等 AI 助手直接操作 Figma 文件。本地模式通过 Desktop Bridge 插件以 WebSocket 连接，提供约 130 个工具：提取变量、组件和样式，用 Figma Plugin API 创建界面，查看控制台日志和截图，做无障碍检查、设计-代码一致性比对，以及操作 FigJam 白板和幻灯片 文档站。

它适合希望通过自然语言提示完成 Figma 工作，或把设计 token 和组件规格同步到代码库的设计师与开发者。

快速使用

推荐本地模式，需要 Node.js 18+、Figma Desktop（不是网页版）、一个 MCP 客户端，以及以 figd_ 开头的 Figma 个人访问令牌。创建令牌时授予 File content、File versions、Library content、Library assets、Comments 和 Current user 权限；Variables 权限仅企业版可用 安装指南。

1. 在 Claude Code 中注册服务器：

claude mcp add figma-console -s user -e FIGMA_ACCESS_TOKEN=figd_YOUR_TOKEN_HERE -e ENABLE_MCP_APPS=true -- npx -y figma-console-mcp@latest

Cursor、Windsurf 或 Claude Desktop 则在各自的配置文件中添加对应的 mcpServers JSON 条目。

2. 打开 Figma Desktop，进入 Plugins → Development → Import plugin from manifest...，选择 ~/.figma-console-mcp/plugin/manifest.json。需要确切路径时运行 npx figma-console-mcp --print-path；macOS 会隐藏以点开头的目录，可在对话框中按 ⌘⇧G。

3. 重启 MCP 客户端，然后依次发送 Check Figma status 和 Create a simple frame with a blue background，确认读取和写入都正常 测试提示。

其他连接方式

• 云模式不需要 Node.js：在网页版 AI 客户端添加 https://figma-console-mcp.southleft.com/mcp 连接器，再用 6 位配对码连接 Desktop Bridge 插件。提供 105 个工具，但没有实时监控和代码库提取。
• Remote SSE 是只读的：用 npx -y mcp-remote@latest 连接 SSE 端点。Claude Code 原生 SSE 传输有已知 bug，README 建议改用 mcp-remote 说明。
• 本地 Git 面向贡献者，执行 npm install && npm run build:local 从源码构建，获得完整 130 个工具和源码访问。

使用约束

通过桥接插件进行写操作需要 Figma Desktop；Remote SSE 无法创建或修改设计。云模式经 Plugin API 管理变量，免费、专业和组织版均可使用，而本地模式的令牌权限说明中 Variables 标注为企业版。figma_ds_* 系列代码库转设计系统工具会读写本地文件，只在本地模式注册。自 v1.10.0 起，多实例支持自动使用 9223–9232 端口。项目采用 MIT 许可证，README 将其定位为 Figma 官方 MCP 服务器的补充而非替代。

HotRepo 点评

2026-11-05 该项目在 TypeScript 日榜新增 242 星，位列第 7。这只是单日快照，不能当作趋势，但说明当天 MCP 接 Figma 的工作流受到关注。README 的详尽程度——130 个工具的清单、四种安装方式的对比、v1.46.0 的版本说明——更像持续维护的工具，而不是简单的连接器。评估时可以权衡准备成本（Node.js、桌面插件、令牌权限）与自己想交给 AI 助手处理的 Figma 工作量。