Fastexcel MCP Server

🚀 FastExcel MCP 服务器

FastExcel MCP 服务器是一个用 Java 实现的 MCP（模型上下文协议）服务器，主要用于处理 Excel 操作，并且支持标准头列关系，能有效提升 Excel 数据处理的效率。

🚀 快速开始

若要在项目中使用此服务器，需满足以下环境要求并执行相应的构建命令。

环境要求

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

构建命令

执行以下 Maven 命令：

mvn clean install

✨ 主要特性

• 可读取 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 // 最大缓存文件数
    }
  }
}

📄 许可证

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