Figma MCP Server

Figma MCP 服务

覆盖完整 Figma REST API 的本地 MCP 服务。适用于 Claude Desktop、Cursor、VS Code、Gemini CLI 以及任何 MCP 客户端。可在 npm 和官方 MCP Registry 获取。

工作原理

每个 Figma REST 端点都作为一个自描述 MCP 工具公开，并在启动时从 tools/figma/ 自动发现，因此添加端点只需添加一个文件。每次调用前都会验证必需参数。它通过 stdio 运行。

前提条件

需要 Bun ≥ 1.2。它原生支持 Bun，因此请使用 bunx 启动，而不是 npx（不支持 Node）。

Figma API 密钥

在 Figma 中依次前往 Settings > Security > Personal access tokens > Generate new token，创建个人访问令牌。将其作为 FIGMA_API_KEY 提供，最好放在客户端配置的 env 块中（见下文）。

配置客户端

所有客户端使用同一个服务。将 command 指向 bunx；如果客户端无法在 PATH 中找到它，也可以指向其绝对路径（which bunx）。

{
  "mcpServers": {
    "figma": {
      "command": "bunx",
      "args": ["figma-mcp-server"],
      "env": {
        "FIGMA_API_KEY": "your_figma_api_key_here"
      }
    }
  }
}

配置文件位置：

• Claude Desktop：Settings > Developer > Edit Config（claude_desktop_config.json）
• Cursor：~/.cursor/mcp.json，或项目级的 .cursor/mcp.json
• Gemini CLI：~/.gemini/settings.json

编辑配置后，重启客户端。

VS Code

使用工作区中的 .vscode/mcp.json 或用户级 mcp.json，并添加 servers 键。不要将令牌硬编码，而是定义一个输入项，让 VS Code 安全地提示输入：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "figma-api-key",
      "description": "Figma API Key",
      "password": true
    }
  ],
  "servers": {
    "figma": {
      "command": "bunx",
      "args": ["figma-mcp-server"],
      "env": {
        "FIGMA_API_KEY": "${input:figma-api-key}"
      }
    }
  }
}

• 使用 ${input:figma-api-key} 时，VS Code 会在服务首次启动时提示输入密钥，然后将其存储在操作系统的机密存储中。
• 若要重新输入或清除：打开命令面板 → MCP: List Servers → 选择服务 → 重置/编辑其输入项。

工具覆盖范围

完整覆盖 Figma REST API（非弃用端点），共 50 个工具，涵盖：

• 文件和节点（文件、节点树、图像渲染、图像填充、元数据、版本历史记录）
• 变量/设计令牌（读取、已发布、批量修改）
• 组件、组件集和样式（文件、已发布和团队范围）
• 评论和回应
• 文件夹（顶层文件夹、子文件夹、文件、元数据）
• 用户
• Dev 资源
• Webhook（v2）
• 库分析（组件、样式和变量的操作与使用情况）
• 组织：活动日志、开发者日志、AI 使用情况（Enterprise）
• 嵌入和付款

请查看 MCP 客户端的工具列表，获取完整且始终最新的工具名称和参数列表。

计划要求

大多数工具可使用任何计划的个人访问令牌。以下工具需要更高级别的计划：

• 变量（list_file_variables、get_published_variables、modify_variables）：Enterprise 组织。
• 库分析（get_library_*）：Organization 或 Enterprise 计划。
• 活动日志、开发者日志、AI 使用情况：Enterprise 组织，并需使用管理员或计划访问令牌。

---

MIT 许可证 · 作者 @planetabhi ⋛⋋( ⊙◊⊙)⋌⋚