项目简介

Excel Reader MCP 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为LLM应用提供读取和解析Excel文件的能力。通过 'read_excel' 工具，LLM可以方便地获取Excel文件中的数据，并支持分块读取大型文件，有效处理数据量限制。

主要功能点

• 读取Excel文件: 支持读取 '.xlsx' 和 '.xls' 格式的Excel文件。
• 自动分块: 对于大型Excel文件，自动分割成多个数据块返回，避免单次请求数据量过大。
• 指定工作表: 可以选择读取指定名称的工作表，默认为第一个工作表。
• 分页读取: 支持指定起始行和最大行数，实现分页读取，控制每次读取的数据量。
• 日期处理: 能够正确处理Excel文件中的日期格式。
• 错误处理: 提供文件不存在、文件格式错误等异常处理机制。

安装步骤

1. 全局安装: 使用 npm 全局安装 'excel-reader' 包：

   npm install -g @archimdescrypto/excel-reader
   

服务器配置

要将 Excel Reader MCP 服务器添加到 MCP 客户端（例如 Claude），您需要配置客户端的 MCP 服务器设置。在客户端的配置文件（通常是 '~/.config/claude/settings.json' 或类似位置）中，添加以下 JSON 配置：

{
  "mcpServers": {
    "excel-reader": {
      "command": "excel-reader",
      "env": {}
    }
  }
}

配置参数说明：

• 'server name': 'excel-reader' (服务器名称，可以自定义)
• 'command': 'excel-reader' (启动服务器的命令，假设安装后 'excel-reader' 命令已添加到系统 PATH 环境变量)
• 'env': '{}' (环境变量，此处为空)

基本使用方法

配置完成后，在支持 MCP 的 LLM 客户端中，您可以指示模型读取 Excel 文件。例如，您可以向 Claude 提出类似这样的指令：

读取路径为 /path/to/your/file.xlsx 的 Excel 文件

LLM 客户端会自动调用 'read_excel' 工具，并将文件路径 '/path/to/your/file.xlsx' 作为参数传递给 Excel Reader MCP 服务器。服务器会将Excel文件内容读取并返回给 LLM 客户端，客户端即可利用这些数据进行后续处理。

对于大型文件，服务器会自动分块返回数据。如果需要读取后续数据块，客户端可以根据返回结果中的 'nextChunk' 信息，构造新的请求以获取下一部分数据。

您还可以通过自然语言指令指定要读取的工作表名称和行范围（如果 LLM 客户端支持将这些信息转换为工具参数）。