Figma Chunked

🚀 Figma MCP 服務器帶分塊處理

一個用於與 Figma API 交互的模型上下文協議（MCP）服務器，內置內存高效的分塊處理和分頁功能，適用於處理大型 Figma 文件，能有效解決大型文件處理時的內存和性能問題。

🚀 快速開始

此 MCP 服務器提供了一個強大的接口來與 Figma API 交互，並帶有內置的內存管理功能。它專為處理大型 Figma 文件而設計，通過將操作分解為可管理的塊並實施分頁（如果需要）來實現高效處理。

✨ 主要特性

• 內存感知處理，帶可配置限制
• 大文件數據檢索的分塊處理
• 所有列表操作的分頁支持
• 節點類型過濾
• 進度跟蹤
• 可配置的塊大小
• 使用遊標恢復功能
• 詳細的調試日誌
• 詳細的錯誤處理

📦 安裝指南

方式一：通過 Smithery 平臺安裝

1. 訪問 Smithery。
2. 搜索並選擇“Figma MCP 服務器帶分塊處理”工具包。
3. 根據提示完成安裝流程。

方式二：手動安裝（適用於高級用戶）

1. 克隆此倉庫到本地開發環境：

git clone https://github.com/your-username/figma-mcp-chunked.git

2. 安裝所有依賴項：

npm install

3. 啟動服務器：

node index.js

📚 詳細文檔

配置說明

使用環境變量配置

通過設置以下環境變量來調整服務器行為：

• MCP_SERVER_PORT：指定服務器運行的端口（默認值為 3000）
• MCP_API_KEY：指定用於與 Figma API 交互的密鑰
• MCP_DEBUG_MODE：啟用調試模式（可選值為 true 或 false）

使用配置文件

創建一個 config.json 文件，並在其中指定以下參數：

{
  "port": 3000,
  "apiKey": "your-api-key",
  "debugMode": true
}

工具使用指南

MCP 工具集

以下是可用的 MCP 工具及其說明：

基礎用法

• get_file_data：獲取文件數據
  • 參數要求：
    • fileKey：必須，指定要檢索的文件密鑰
    • accessToken：必須，用於身份驗證的訪問令牌
  • 使用示例：

curl -X POST http://localhost:3000/mcp/tool/get_file_data \
  -H "Content-Type: application/json" \
  -d '{"fileKey":"your-file-key","accessToken":"your-access-token"}'

高級用法

• process_blocks：處理數據塊
  • 參數要求：
    • blockSize：可選，指定每個塊的大小（默認為 100）
    • maxMemoryMB：可選，指定最大內存使用限制（以 MB 為單位，默認為 512）

內存管理策略

分塊處理的最佳實踐

1. 起始較小的塊大小：從每個塊處理 50 到 100 個節點開始，並根據性能調整。
2. 監控內存使用情況：通過響應元數據跟蹤內存使用情況。
3. 使用節點類型過濾：儘可能減少數據負載。
4. 實施分頁：對於大數據集使用分頁。
5. 指定較小的深度值：在處理嵌套結構時。

可配置選項

• pageSize：每個塊中的節點數量（默認為 100）
• maxMemoryMB：最大內存使用限制（以 MB 為單位，默認為 512）
• nodeTypes：過濾特定的節點類型
• depth：控制嵌套結構的遍歷深度

調試日誌

服務器包含詳細的調試日誌：

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

錯誤處理

服務器提供詳細的錯誤消息和建議：

// 內存限制錯誤
"響應太大。嘗試使用較小的深度值或指定 node_id。"

// 參數錯誤
"缺少必需參數：fileKey 和 accessToken"

// API 錯誤
"Figma API 錯誤：[詳細信息]"

故障排除

常見問題

1. 內存錯誤

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

2. 性能問題

   • 監控內存使用情況
   • 調整塊大小
   • 使用適當的節點類型篩選器
   • 實現經常訪問數據的緩存

3. API 限制

   • 實現速率限制
   • 使用分頁
   • 在可能的情況下緩存響應

調試模式

啟用調試日誌以獲取詳細信息：

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

開發與貢獻

• 問題報告：在 GitHub Issues 上提交任何遇到的問題或功能請求。
• 代碼貢獻：歡迎 fork 倉庫並提出拉取請求，幫助改進工具。

📄 許可證

項目遵循 MIT License，詳細信息請參閱許可證文件。