Fastexcel MCP Server

🚀 FastExcel MCP 服務器

FastExcel MCP 服務器基於 Java 實現，用於進行 Excel 操作。它遵循模型上下文協議 (MCP)，具備標準化的頭與列關係映射，能高效處理各類 Excel 文件。

🚀 快速開始

如果使用 Claude Desktop，請在配置文件中添加 MCP 服務器信息：

{
  "mcpServers": [
    {
      "name": "FastExcelMCP",
      "executable": "/path/to/javacExecutable",
      "options": ["-Dsome.option=value"],
      "jvmArgs": [],
      "workingDir": "."
    }
  ]
}

需要 JDK 17+ 和 Maven 3.9.6+，通過以下命令構建：

mvn clean install

✨ 主要特性

• 可讀取 Excel 文件（XLSX、XLS、CSV）的標題和數據行。
• 能驗證輸入路徑是否在配置的工作區範圍內。
• 支持多個工作表和自定義標題行。
• 可獲取總數據行數（不包括標題行）。
• 內置性能緩存，以實現更快的重複訪問速度。

⚠️ 重要提示

服務器僅允許在通過 env: MCP_WORKSPACES 配置的工作區目錄內進行操作。

📚 詳細文檔

工具

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 (整數，可選)：要讀取的數據行數目（不包括標題）。若為空，則讀取所有數據行。
  • sheetName (字符串，可選)：要讀取的工作表名稱。若為空，則默認為第一個工作表。
• 輸出：
  • 返回一個包含行數據及其對應標題的列表。

cache_clear

清除內存中的所有 Excel 文件緩存數據。

• 輸出：
  • 成功清除緩存時返回 true。

test_cache_available

測試指定 Excel 文件是否存在於緩存中。

• 輸出：
  • 返回一個布爾值，表示文件是否在緩存中。

📄 許可證

該軟件採用 Apache License 2.0 許可證。