FastExcel MCP 服务器

一个用 Java 实现的 MCP（模型上下文协议）服务器，用于处理 Excel 操作并支持标准头列关系。

功能

• 读取 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 文件的绝对路径或相对路径。
  • 返回布尔值，表示文件是否在缓存中。

使用说明（与 Claude Desktop 配合使用）

要在 Claude Desktop 中使用此服务器，请将以下内容添加到配置文件 claude_desktop_config.json：

{
  "fastExcelMcpServer": {
    "enabled": true,
    "config": {
      "mcpEndpoint": "http://localhost:8080", // MCP 服务的端点地址
      "workSpaceRoot": "/path/to/workspace", // 工作空间根目录
      "cacheExpiration": 3600, // 缓存过期时间（秒）
      "maxCacheSize": 1000 // 最大缓存文件数
    }
  }
}

构建

环境要求

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

构建命令

要在项目中使用此服务器，请执行以下 Maven 命令：

mvn clean install

许可证

该服务器遵循 Apache License 2.0 许可证。