Fastexcel MCP Server

🚀 FastExcel MCP 服務器

FastExcel MCP 服務器是一個用 Java 實現的 MCP（模型上下文協議）服務器，主要用於處理 Excel 操作，並且支持標準頭列關係，能有效提升 Excel 數據處理效率。

🚀 快速開始

要在項目中使用此服務器，首先需要進行構建。構建前需滿足以下環境要求：

• JDK 8 或更高版本
• Maven 3.6 或更高版本

執行以下 Maven 命令進行構建：

mvn clean install

若要在 Claude Desktop 中使用此服務器，請將以下內容添加到配置文件 claude_desktop_config.json：

{
  "fastExcelMcpServer": {
    "enabled": true,
    "config": {
      "mcpEndpoint": "http://localhost:8080", // MCP 服務的端點地址
      "workSpaceRoot": "/path/to/workspace", // 工作空間根目錄
      "cacheExpiration": 3600, // 緩存過期時間（秒）
      "maxCacheSize": 1000 // 最大緩存文件數
    }
  }
}

✨ 主要特性

• 可讀取 Excel 文件（XLSX、XLS、CSV）的表頭和數據行。
• 能驗證輸入路徑是否符合配置的工作空間。
• 支持多張表格和自定義表頭行。
• 可獲取 Excel 文件中的總數據行數（不包括表頭）。
• 內置性能緩存功能，實現更快的重複訪問。

⚠️ 重要提示

該服務器僅允許在 env: MCP_WORKSPACES 配置的工作目錄內執行操作。

📚 詳細文檔

API

工具

• get_total_rows_number (帶緩存支持)

  • 功能：獲取 Excel 文件中數據行的總數（不包括表頭行）。
  • 輸入：
    • excelPath (字符串)：Excel 文件的絕對路徑或相對路徑。
    • headRowNumber (整數)：表頭所在的行號（1 基數索引）。
    • sheetName (字符串，可選)：要讀取的工作表名稱。如果為空，則默認使用第一張工作表。
  • 返回值：返回數據行的總數作為整數。

• get_sheet_names (帶緩存支持)

  • 功能：檢索 Excel 文件中的所有工作表名稱及其索引。
  • 輸入：
    • excelPath (字符串)：Excel 文件的絕對路徑或相對路徑。
  • 返回值：返回一個包含工作表編號和名稱的對象列表。

• read_head_spec (帶緩存支持)

  • 功能：解析並返回 Excel 文件中的頭信息。
  • 輸入：
    • excelPath (字符串)：Excel 文件的絕對路徑或相對路徑。
    • headRowNumber (整數)：表頭所在的行號（1 基數索引）。
    • sheetName (字符串，可選)：要讀取的工作表名稱。如果為空，則默認使用第一張工作表。
  • 返回值：返回一個按順序排列的列索引和標題對象列表。

• read_rows_spec (帶緩存支持)

  • 功能：解析並返回與頭關聯的數據行信息。
  • 輸入：
    • excelPath (字符串)：Excel 文件的絕對路徑或相對路徑。
    • headRowNumber (整數)：表頭所在的行號（1 基數索引）。
    • readRowNumbers (整數，可選)：要讀取的數據行數（不包括表頭）。如果為 null，則讀取所有數據行。
    • sheetName (字符串，可選)：要讀取的工作表名稱。如果為空，則默認使用第一張工作表。
  • 返回值：返回一個包含行數據及其標題鏈接的對象列表。

• cache_clear

  • 功能：從內存中清除所有緩存的 Excel 文件數據。
  • 返回值：成功清除時返回 true。

• test_cache_available

  • 功能：檢查指定的 Excel 文件是否在緩存中可用。
  • 輸入：
    • excelPath (字符串)：Excel 文件的絕對路徑或相對路徑。
  • 返回值：返回布爾值，表示文件是否在緩存中。

📄 許可證

該服務器遵循 Apache License 2.0 許可證。