Figma MCP Server

🚀 Figma MCP 服務器

Figma MCP 服務器是一個與 Figma API 集成的模型上下文協議 (MCP) 服務器，可讓您方便地與 Figma 文件、評論、組件等進行交互，提升工作效率。

🚀 快速開始

要使用 Figma MCP 服務器，您需要先進行安裝和配置，之後就可以使用提供的工具進行各類操作。

✨ 主要特性

• 文件操作
  • 獲取文件信息
  • 獲取文件版本歷史
  • 獲取文件組件
• 評論管理
  • 列出文件中的評論
  • 添加新評論
  • 刪除評論
• 項目與團隊特性
  • 列出團隊的項目
  • 獲取項目的文件
  • 獲取已發佈的樣式
• 網鉤管理
  • 創建網鉤
  • 列出現有的網鉤
  • 刪除網鉤

📦 安裝指南

通過 Smithery 安裝

要通過 Smithery 自動安裝 Figma MCP Server for Claude Desktop，可執行以下命令：

npx -y @smithery/cli install @deepsuthar496/figma-mcp-server --client claude

手動安裝

1. 克隆倉庫
2. 安裝依賴：

npm install

3. 構建服務器：

npm run build

📚 詳細文檔

配置

在您的 MCP 設置文件中使用 Figma 訪問令牌配置服務器：

{
  "mcpServers": {
    "figma": {
      "command": "node",
      "args": ["path/to/figma-server/build/index.js"],
      "env": {
        "FIGMA_ACCESS_TOKEN": "your-access-token-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

可用工具

文件操作

• get_file：獲取文件信息

{
  "file_key": "string"
}

• get_file_versions：獲取文件版本歷史

{
  "file_key": "string"
}

• get_file_components：獲取文件組件

{
  "file_key": "string"
}

評論管理

• get_file_comments：列出文件中的評論

{
  "file_key": "string"
}

• post_comment：添加文件的評論

{
  "file_key": "string",
  "message": "string"
}

• delete_comment：刪除文件中的評論

{
  "file_key": "string",
  "comment_id": "string"
}

項目與團隊特性

• get_team_projects：獲取團隊的項目

{
  "team_id": "string"
}

• get_project_files：獲取項目的文件

{
  "project_id": "string"
}

• get_component_styles：獲取已發佈的樣式

{
  "team_id": "string"
}

網鉤管理

• create_webhook：創建網鉤

{
  "team_id": "string",
  "event_type": "string",
  "callback_url": "string"
}

• list_webhooks：列出網鉤

{
  "team_id": "string"
}

• delete_webhook：刪除網鉤

{
  "webhook_id": "string"
}

💻 使用示例

基礎用法

```figma
Figma 客戶端 ID: your_client_id_here
Figma 客戶端Secret: your_client_secret_here

要獲取文件信息：

curl -X GET 'https://api.figma.com/v1/files/[file_key]'
  -H 'Authorization: Bearer [access_token]'

要獲取文件版本歷史：

curl -X GET 'https://api.figma.com/v1/files/[file_key]/versions'
  -H 'Authorization: Bearer [access_token]'

要添加評論：

curl -X POST 'https://api.figma.com/v1/comments'
  -H 'Content-Type: application/json'
  -d '{"file_key": "your_file_key", "message": "your_message"}'

📄 許可證

[許可證內容]

🤝 貢獻指南

歡迎為這個項目做出貢獻！請參考以下步驟進行貢獻：

1. 克隆倉庫
2. 創建功能分支
3. 提交您的更改
4. 推送到遠程倉庫
5. 提交拉取請求

請確保在提交代碼前檢查代碼格式，併為您的更改添加適當的文檔。