figma-console-mcp

把 Figma 设计系统变成 AI 能直接调用的接口

开源 🏷️定价信息待确认 ⚠️ 链接可跳转,访问体验不确定 设计创意 🍴 复刻 309 🐛 待处理 20 👀 关注 28
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 3383
维护状态 较活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

figma-console-mcp 项目界面预览图
图片来源:项目官网

项目数据

分类设计创意
开发团队southleft
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态⚠️ 链接可跳转,访问体验不确定
是否开源是
开源协议MIT
主要语言TypeScript
技术栈/模型ai,design-systems,figma,figma-api,figma-plugins,mcp
GitHub 星标★ 3383
上线时间2025-10-05 00:00:00
代码更新2026-11-13
仓库体积3.9 MB
本站数据更新2026-11-22
维护状态较活跃
收录时间2026-10-08
浏览次数3

项目介绍

figma-console-mcp 是一个把 Figma 设计系统变成 API 的 MCP 服务器,用 TypeScript 编写。它解决的核心问题是:AI 编码工具(如 Claude、Cursor 等)无法直接读取或操作 Figma 文件,导致设计稿与代码之间需要人工搬运。项目通过 MCP 协议把 Figma 的变量、样式、组件、文本等内容暴露成可调用的工具接口,让 AI 能提取设计 token、读取节点结构、创建和修改元素,甚至执行调试命令。核心能力包括:连接 Figma 桌面端或插件桥接、批量导出设计变量与样式、按节点 ID 查询图层信息、在 Figma 中生成新节点,以及运行控制台脚本排查问题。它适合把设计系统接入 AI 工作流,减少手工对照设计稿写代码的重复劳动,让设计规范更自动地流向实现层。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-08 · 当前星标 ★ 3383

技术标签

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 10 分钟 部署方式:命令行工具 7 步

环境要求

  • Node.js(NPX / Local Git 模式需要;Cloud Mode 与 Remote SSE 不需要)
  • 一个可用的 Figma 账号(NPX 与 Local Git 模式需手动配置 PAT)
  • 支持 MCP 的 AI 客户端(如 Claude、Cursor 等)
  • 如需写入 Figma:Figma 桌面端(正常启动即可,无需 debug 参数)

安装与启动步骤

  1. 1选择安装方式

    按目标对照官方表格选择:要与 AI 一起创建/修改设计选 NPX 推荐;Web 端 AI 选 Cloud Mode;想贡献代码选 Local Git;只想只读浏览选 Remote SSE。

  2. 2准备 Figma 凭证

    NPX 与 Local Git 模式使用手动 PAT 认证;Cloud Mode 和 Remote SSE 使用 OAuth 自动认证,无需手动配置令牌。

  3. 3克隆仓库(本地模式)

    仅 Local Git / 贡献者模式需要,克隆后按仓库说明安装依赖;NPX、Cloud、Remote SSE 三种方式可跳过此步。

    git clone https://github.com/southleft/figma-console-mcp.git
  4. 4打开 Figma 桌面端

    正常启动 Figma 桌面端即可,README 明确说明不需要任何 debug 启动参数。

  5. 5导入桌面桥插件

    在 Figma 中进入 Plugins → Development → Import plugin from manifest...,选中 figma-console-mcp 目录下的 figma-desktop-bridge/manife

  6. 6运行插件连接

    在你的 Figma 文件中运行该插件,它会通过 WebSocket 自动连接,自动扫描 9223–9232 端口,无需手动指定端口。

  7. 7让 AI 验证连接

    向你的 AI 助手提问“Check Figma status”,返回已连接状态即表示 MCP 与 Figma 通道打通。

关键配置

配置项必填说明示例
PAT是NPX 与 Local Git 模式下手动配置的 Figma 个人访问令牌figd_xxxxxxxxxxxxxxxx
WebSocket 端口范围否桌面桥插件自动扫描的本地端口,无需手动设置9223–9232

如何确认成功

向 AI 提问 “Check Figma status”,确认返回已连接 Figma、工具可用即成功。

常见问题

Q:使用变量功能需要 Figma 企业版吗?

A:不需要。README 的对比表显示 NPX、Cloud Mode、Local Git 三种方式均支持 Variables (no Enterprise)。

Q:只想读取设计数据,最快怎么装?

A:选 Remote SSE,约 2 分钟完成,无需 Node.js、OAuth 自动认证,但只有只读工具子集。

Q:Cloud Mode 需要装 Node.js 吗?

A:不需要。Cloud Mode 面向 Claude.ai、v0、Replit、Lovable 等 Web AI 客户端,配对后提供 96 个工具。

Q:桌面桥插件每次都要重新导入吗?

A:不用。属于一次性导入,之后它会留在 Development plugins 列表里,需要时直接运行即可。

Q:Figma 桌面端要开调试参数吗?

A:不用。README 说明按正常方式启动 Figma Desktop 即可,无任何 debug flags 要求。

注意事项

  • NPX(推荐)与 Local Git 提供全部 121 个工具,Remote SSE 仅只读子集,Cloud Mode 配对后为 96 个工具。
  • 只有 NPX 与 Local Git 需要 Node.js;Cloud Mode 与 Remote SSE 不依赖 Node.js。
  • NPX 方式通过 @latest 自动更新,Local Git 方式需要手动 git pull 更新。
  • 当前版本 v1.40.9 的修复属于服务端更新,无需重新导入 Figma 插件。

核心亮点

  • 通过 MCP 协议直接对接 Claude、Cursor 等 AI 工具,无需自己写胶水代码
  • 能读取 Figma 变量、样式、组件等设计 token,方便生成与设计一致的代码
  • 支持在 Figma 中创建和修改节点,不只是只读提取,可反向写入

不足之处

  • 依赖 Figma 桌面端或插件桥接,环境配置有一定门槛
  • 功能深度受 Figma API 与插件权限限制,复杂交互场景覆盖有限

适用场景

  • 把设计系统的颜色、字体、间距变量同步给 AI 生成主题代码
  • 让 AI 根据 Figma 节点结构直接产出组件代码骨架
  • 在设计评审后批量修改 Figma 中的文案或样式并回写

替代项目

figma-mcp、Figma-Context-MCP

上一篇:simple-ai

下一篇:swiss-design-skill

同类项目推荐

snek 开源

用代码画出有机流动的生成艺术,适合 Lisp 爱好者研究

See https://github.com/inconvergent/weir instead

★ 753 2026-08-09
mandelbrot 开源

一行命令画出经典曼德博分形,入门分形编程首选

Simple Mandelbrot

★ 60 2026-08-09
figures4papers 开源

一键生成顶会论文级图表,告别丑陋配图

My Python scripts to make high-quality figures for publications in top AI conference···

★ 12343 2026-08-09
superdesign-skill 开源

一键洗掉 AI 味,粗糙界面秒变高级

The design skill for Claude Code, Cursor and any coding agent. Stop shipping AI-slop···

★ 1040 2026-08-09
there-are-stars 开源

每收一颗星,故事自动长一段,让社区帮你写书

A self-generating story that gets longer the more stars it gets

★ 357 2026-08-09
open-codesign 开源

说一句想法,原型和幻灯片一次给全

Open-source Claude Design alternative. One-click import your Claude Code / Codex API···

★ 8249 2026-08-09
factorio-blueprint-visualizer 开源

把《异星工厂》蓝图字符串变成高清图片,直观预览和分享。

A python library to artfully visualize Factorio Blueprints and an interactive web de···

★ 585 2026-08-09
lazy-pony-prompter 开源

接上 boorus,自动补全 pony 提示词,告别手打标签

Image boorus API powered pony prompt helper extension for A1111 / Forge and ComfyUI

★ 55 2026-08-09
stack-diagram 开源

一句话描述技术栈,自动生成带官方 Logo 的架构图

Agent skill: describe your stack in a sentence, get an architecture diagram with off···

★ 2689 2026-11-05