Figma MCP Server

Figma MCP Server

site icon
2025.03.27 1
设计工具集成AI 辅助开发开发效率
Figma-Context-MCP 是一个基于 Model Context Protocol (MCP) 的服务,旨在为 AI 驱动的编码工具(如 Cursor、Windsurf、Cline 等)提供对 Figma 设计数据的访问。通过简化 Figma API 的响应,该服务仅提供最相关的布局和样式信息,从而提高 AI 工具的准确性和响应相关性。
View on GitHub

Overview

基本能力

产品定位

Figma-Context-MCP 是一个桥梁服务,连接 Figma 设计数据和 AI 编码工具,帮助开发者更高效地将设计转化为代码。

核心功能

  1. Figma 数据访问:通过 Figma API 获取设计文件的元数据。
  2. 数据简化与翻译:优化 API 响应,仅提供最相关的设计信息。
  3. 工具集成:支持与 Cursor、Windsurf、Cline 等工具的集成。
  4. 多模式运行:支持 HTTP/SSE 和命令行模式(stdio)。

适用场景

  1. 设计实现:将 Figma 设计快速转化为代码。
  2. AI 辅助开发:为 AI 工具提供设计上下文,提高代码生成准确性。
  3. 团队协作:在设计团队和开发团队之间建立更高效的协作流程。

工具列表

  1. get_figma_data:获取 Figma 文件或特定节点的信息。
  2. 参数:fileKey(必需)、nodeId(可选)、depth(可选)。
  3. download_figma_images(开发中):下载 Figma 文件中的 SVG 和 PNG 图像。
  4. 参数:fileKeynodes(包含 nodeIdimageReffileName)、localPath

常见问题解答

  1. 如何获取 Figma API 访问令牌?
  2. 参考 Figma 官方文档
  3. 如何确认 Cursor 已成功连接?
  4. 检查 Cursor 设置中的连接状态,确认绿色圆点显示。
  5. 如何优化 AI 工具的响应?
  6. 提供具体的 Figma 节点链接(如帧或组),而非整个文件链接。

使用教程

使用依赖

  1. Node.js 环境:确保已安装 Node.js。
  2. Figma API 访问令牌:获取并准备好 Figma API 访问令牌。

安装教程

  1. 快速运行(无需安装)bash npx figma-developer-mcp --figma-api-key=<your-figma-api-key>
  2. 从源码运行bash git clone https://github.com/GLips/Figma-Context-MCP cd Figma-Context-MCP pnpm install cp .env.example .env # 编辑 .env 文件,填入 Figma API 访问令牌 pnpm run dev

调试方式

  1. 检查服务器状态bash npx figma-developer-mcp --figma-api-key=<your-figma-api-key> # 确认输出日志显示 HTTP/SSE 服务已启动
  2. 使用检查工具bash pnpm inspect # 访问 http://localhost:5173 查看 MCP Inspector
  3. 验证 Cursor 连接
  4. 在 Cursor 设置中确认连接状态为绿色圆点。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。