mcp-figma

🚀 mcp-figma 中文文档

mcp-figma 是一个专为 Figma API 集成设计的模型上下文协议 (MCP) 服务器，可与 Claude 及其他兼容 MCP 的人工智能助手协同工作，为用户提供便捷的 Figma API 访问体验。

🚀 快速开始

mcp-figma 是一个为 Figma API 集成设计的模型上下文协议 (MCP) 服务器，可与 Claude 等兼容 MCP 的人工智能助手配合使用，实现对 Figma API 的多种功能访问。

✨ 主要特性

此 MCP 服务器提供对 Figma API 的以下功能访问：

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

📦 安装指南

使用 NPM 安装

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

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

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

💻 使用示例

与 Claude 配合使用

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

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

2. 当使用 Claude 时，第一次需要设置您的 Figma API 密钥：

请使用 mcp-figma 设置我的 Figma API 密钥：figd_xxxxxxxxxxxxxxxxxxxxxxx

您的密钥将存储在 ~/.mcp-figma/config.json 中，并在以后的会话中自动加载。 3. 检查是否已配置 API 密钥：

请使用 mcp-figma 检查我的 API 密钥状态

4. 然后使用提供的任何 Figma API 功能：

请使用 mcp-figma 获取具有密钥 abc123 的文件

可用工具

该服务器提供以下工具：

• 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：获取文件上的评论
• post_comment：在文件上发布评论
• delete_comment：从文件中删除评论
• 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：通过密钥获取样式

有关详细使用示例，请参阅 USAGE.md。

📄 许可证

MIT