Figma MCP Server With Chunking

🚀 Figma MCP 服務器帶分塊功能

本項目是一個與 Figma API 交互的 Model Context Protocol (MCP) 服務器，內置內存高效的分塊和分頁功能，能夠有效處理大文件，極大提升了處理效率和內存利用率。

🚀 快速開始

此文檔將詳細介紹“帶分塊功能的 Figma MCP 服務器”（以下簡稱“服務器”）的使用方法，涵蓋安裝、配置、工具使用、內存管理等相關指南。

✨ 主要特性

• 與 Figma API 交互，實現數據獲取與處理。
• 內置內存高效的分塊和分頁功能，適合處理大文件。
• 支持環境變量和配置文件兩種配置方式。
• 提供多種工具，如獲取文件數據和列出文件工具。
• 具備完善的內存管理策略和錯誤處理機制。

📦 安裝指南

通過 Smithery 安裝

# 使用以下命令安裝：
figma-mcp-server --install

手動安裝（可選）

# 克隆倉庫：
git clone https://github.com/your-repository.git
cd figma-mcp-server

# 安裝依賴：
npm install

# 啟動服務器：
node index.js

📚 詳細文檔

配置指南

環境變量配置

設置以下環境變量以配置服務器行為：

• FIGMA_ACCESS_TOKEN：Figma 訪問令牌
• MAX_MEMORY_MB：最大允許內存（單位：MB）
• DEFAULT_CHUNK_SIZE：默認分塊大小（單位：節點）

配置文件加載

創建或修改 config.json 文件，添加以下內容：

{
  "accessToken": "your-figma-token",
  "maxMemory": 512,
  "chunkSize": 100
}

工具使用指南

獲取文件數據工具 (get_file_data)

• 功能說明：
  • 輸入：fileKey 和 accessToken
  • 輸出：返回指定文件的數據分塊，支持分頁和篩選
• 使用示例：

# 請求參數：
{
  "tool": "get_file_data",
  "arguments": {
    "fileKey": "abc123",
    "nodeTypes": ["rectangle", "ellipse"]
  }
}

# 返回數據：
{
  "data": {
    "nodes": [ ... ],
    " pageInfo": { "hasNext": true, "cursor": "xyz456" }
  },
  "metadata": {
    "memoryUsage": 256,
    "responseTime": 500
  }
}

列出文件工具 (list_files)

• 功能說明：
  • 輸入：accessToken
  • 輸出：返回用戶所有 Figma 文件列表
• 使用示例：

# 請求參數：
{
  "tool": "list_files",
  "arguments": {
    "accessToken": "your-figma-token"
  }
}

# 返回數據：
{
  "data": { "files": [...] },
  "metadata": {}
}

內存管理策略

• 分塊處理：
  • 分塊大小：默認 100 節點，可配置
  • 內存監控：即時跟蹤使用情況
  • 自動調整：根據壓力動態調節
  • 進度跟蹤：每個分塊都有詳細日誌

最佳實踐

1. 初始建議：從小分塊（50 - 100 節點）開始，逐步優化。
2. 監控內存使用情況，通過響應元數據查看。
3. 儘量使用節點類型篩選減少負載。
4. 大數據集時實施分頁。
5. 使用續傳功能處理大文件。

調試日誌

示例輸出

[MCP 調試] 從 config.json 加載配置
[MCP 調試] 找到訪問令牌：xxxxxxx...
[MCP 調試] 請求 { tool: 'get_file_data', arguments: {...} }
[MCP 調試] 響應大小為 2.5 MB

錯誤處理

常見錯誤信息

• 內存限制： "響應過大。請嘗試使用更小的深度值或指定 node_id。"
• 無效參數： "缺少必需參數：fileKey 和 accessToken"
• API 錯誤： "Figma API 錯誤：[詳細信息]"

故障排除

常見問題

1. 內存錯誤：

• 減小分塊大小
• 使用節點類型篩選
• 實施分頁
• 指定較小的深度值

2. 性能問題：

• 監控內存使用情況
• 調整分塊大小
• 使用適當的節點類型過濾器
• 實現頻繁訪問數據的緩存

3. API 限制：

• 實施速率限制
• 使用分頁
• 在可能時進行響應緩存

調試模式啟用

# 設置調試環境變量：
export DEBUG=true

📄 許可證

• 協議：MIT License

項目倉庫

• 地址：https://github.com/your-repository.git

版本信息

• 版本：v1.0.0

⚠️ 重要提示

文檔內容版權歸作者所有，未經授權禁止轉載或複製。