Excel MCP Server

FastExcel MCP Server

使用 Java 实现的 Model Context Protocol（MCP）服务，用于执行 Excel 操作，并采用标准化的表头与列对应关系。

功能

• 读取 Excel 文件（XLSX、XLS、CSV）的表头和数据行。
• 根据已配置的工作区验证输入路径。
• 支持多个工作表和自定义表头行。
• 获取数据行总数（不包括表头）。
• 内置性能缓存，加快重复访问速度。

注意：此服务仅允许在通过 env: MCP_WORKSPACES 指定的目录中执行操作。

API

工具

• get_total_rows_number (支持缓存)

  • 获取 Excel 文件中的数据行总数（不包括表头行）。
  • 输入：
    • excelPath（字符串）：Excel 文件的绝对路径或相对路径。
    • headRowNumber（整数）：表头所在的行号（从 1 开始）。
    • sheetName（字符串，可选）：要读取的工作表名称。如果为空，默认为第一个工作表。
  • 返回数据行总数（整数）。

• get_sheet_names (支持缓存)

  • 获取 Excel 文件中的所有工作表名称及其索引。
  • 输入：
    • excelPath（字符串）：Excel 文件的绝对路径或相对路径。
  • 返回包含工作表编号和名称的 json 对象列表。

• read_head_spec (支持缓存)

  • 解析并返回 Excel 文件中的表头信息。
  • 输入：
    • excelPath（字符串）：Excel 文件的绝对路径或相对路径。
    • headRowNumber（整数）：表头所在的行号（从 1 开始）。
    • sheetName（字符串，可选）：要读取的工作表名称。如果为空，默认为第一个工作表。
  • 返回按顺序排列的 json 对象列表，其中包含列索引和表头标题。

• read_rows_spec (支持缓存)

  • 解析并返回 Excel 文件中的数据行，并将其与表头关联。
  • 输入：
    • excelPath（字符串）：Excel 文件的绝对路径或相对路径。
    • headRowNumber（整数）：表头所在的行号（从 1 开始）。
    • readRowNumbers（整数，可选）：要读取的数据行数（不包括表头）。如果为 null，则读取所有行。
    • sheetName（字符串，可选）：要读取的工作表名称。如果为空，默认为第一个工作表。
  • 返回包含与表头关联的行数据的 json 列表。

• cache_clear

  • 清除内存中缓存的所有 Excel 文件数据。
  • 成功清除缓存时返回 true。

• test_cache_available

  • 测试指定的 Excel 文件是否已缓存。
  • 输入：
    • excelPath（字符串）：Excel 文件的绝对路径或相对路径。
  • 返回指示缓存状态和文件 MD5 哈希值的 json 对象：
    • cached：布尔值，指示文件是否已缓存
    • result：包含文件 MD5 哈希信息的字符串

与 Claude Desktop 搭配使用

将以下内容添加到你的 claude_desktop_config.json 中：

Java

{
  "mcpServers": {
    "fastexcel-mcp-server": {
      "command": "java",
      "args": [
        "-jar",
        "<YOUR_PATH>/fastexcel-mcp-server-0.0.1-SNAPSHOT.jar"
      ],
      "env": {
        "MCP_WORKSPACES": "<YOUR_MULTIPLE_WORKSPACES_SEPARATED_BY_COMMAS>",
        "CACHE_INITIAL_CAPACITY": "[OPTIONAL] <MINIMUM_TOTAL_SIZE_FOR_THE_INTERNAL_DATA_STRUCTURES> <DEFAULT: 100>",
        "CACHE_MAXIMUM_SIZE": "[OPTIONAL] <MAXIMUM_NUMBER_OF_ENTRIES_THE_CACHE_MAY_CONTAIN> <DEFAULT: 1000>",
        "CACHE_EXPIRE_AFTER_WRITE": "[OPTIONAL] <LENGTH_OF_TIME_AFTER_AN_ENTRY_IS_CREATED_THAT_IT_SHOULD_BE_AUTOMATICALLY_REMOVED> <DEFAULT: 35s>"
      }
    }
  }
}

构建

要求

• JDK 17+ GraalVM
• Maven 3.9.6+

Java 构建：

mvn clean package -DskipTests=true

许可证

此 MCP 服务采用 Apache License 2.0 许可证。详情请参阅项目仓库中的 LICENSE 文件。

---

如果你需要进一步的自定义或集成详情，请告诉我！