mcp-figma

基本能力

产品定位

mcp-figma 是一个 Figma API 集成服务，通过 MCP 协议与 AI 助手（如 Claude）交互，提供对 Figma 平台功能的访问。

核心功能

• 文件操作（获取文件、获取节点、获取图片）
• 评论管理
• 团队/项目管理
• 组件和样式访问
• 持久化 API 密钥存储

适用场景

• 在 AI 助手中集成 Figma 功能
• 自动化 Figma 文件操作
• 管理 Figma 团队和项目
• 访问和操作 Figma 组件和样式

工具列表

• set_api_key: 设置 Figma API 个人访问令牌（保存到配置）
• check_api_key: 检查是否已配置 API 密钥
• get_file: 通过密钥获取 Figma 文件
• get_file_nodes: 从 Figma 文件中获取特定节点
• get_image: 获取 Figma 文件中节点的图像
• get_image_fills: 获取 Figma 文件中使用的图像的 URL
• get_comments: 获取 Figma 文件上的评论
• post_comment: 在 Figma 文件上发布评论
• delete_comment: 从 Figma 文件中删除评论
• get_team_projects: 获取团队的项目
• get_project_files: 获取项目的文件
• get_team_components: 获取团队的组件
• get_file_components: 从文件中获取组件
• get_component: 通过密钥获取组件
• get_team_component_sets: 获取团队的组件集
• get_team_styles: 获取团队的样式
• get_file_styles: 从文件中获取样式
• get_style: 通过密钥获取样式

常见问题解答

1. 如何设置 Figma API 密钥？ 使用命令：Please use mcp-figma to set my Figma API key: figd_xxxxxxxxxxxxxxxxxxxxxxx

2. 如何检查 API 密钥是否配置？ 使用命令：Please use mcp-figma to check my API key status

3. 如何获取 Figma 文件？ 使用命令：Please use mcp-figma to get the file with key abc123

使用教程

使用依赖

确保已安装 Node.js 和 npm。

安装教程

# 全局安装
npm install -g mcp-figma

# 或在项目中本地安装
npm install mcp-figma

# 更新到最新版本
npm update -g mcp-figma

调试方式

1. 将 mcp-figma 添加到 Claude 配置中：

"mcp-figma": {
  "command": "npx",
  "args": [
    "-y",
    "mcp-figma"
  ]
}

1. 设置 Figma API 密钥：

Please use mcp-figma to set my Figma API key: figd_xxxxxxxxxxxxxxxxxxxxxxx

1. 验证 API 密钥是否配置：

Please use mcp-figma to check my API key status

1. 使用 Figma API 功能：

Please use mcp-figma to get the file with key abc123

许可证

该项目遵循 MIT 开源许可条款。