Deepsuthar496 Figma MCP Server

🚀 Figma MCP 服務器

Figma MCP 服務器是一個與 Figma API 集成的 Model Context Protocol (MCP) 服務器，它能讓您與 Figma 文件、評論、組件等進行交互，為您在 Figma 平臺上的操作提供便利。

🚀 快速開始

本服務器可幫助您輕鬆實現與 Figma API 的交互，按以下步驟操作即可開啟使用。

✨ 主要特性

• 文件操作
  • 獲取文件信息，助您快速瞭解文件概況。
  • 獲取文件版本歷史，方便追溯文件的變更過程。
  • 獲取文件組件，便於對組件進行管理和使用。
• 評論管理
  • 列出文件中的評論，讓您清晰掌握文件的討論情況。
  • 添加新評論，方便團隊成員交流想法。
  • 刪除評論，可清理不必要的信息。
• 項目與團隊功能
  • 列出團隊的項目，使團隊項目一目瞭然。
  • 獲取項目的文件，便於對項目文件進行操作。
  • 獲取已發佈的樣式，統一團隊的設計風格。
• 網鉤管理
  • 創建網鉤，實現特定事件的自動化觸發。
  • 列出現有的網鉤，方便對網鉤進行管理。
  • 刪除網鉤，可停用不再需要的自動化功能。

📦 安裝指南

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"
}

• get_webhooks：列出網鉤

{
  "team_id": "string"
}

• delete_webhook：刪除網鉤

{
  "webhook_id": "string"
}

💻 使用示例

基礎用法

// 示例：使用 MCP 工具獲取文件信息
<use_mcp_tool>
<server_name>figma</server_name>
<tool_name>get_file</tool_name>
<arguments>
{
  "file_key": "your-file-key"
}
</arguments>
</use_mcp_tool>

📄 許可證

本項目採用 MIT 許可證。

🤝 貢獻指南

如果您想為項目做出貢獻，請按以下步驟操作：

1. 叉倉庫。
2. 創建功能分支。
3. 提交更改。
4. 推送到分支。
5. 創建新的 Pull Request。