Excel Reader Server

一个 Model Context Protocol (MCP) 服务器，提供读取 Excel (xlsx) 文件的工具。

功能特性

• 读取 Excel 文件中所有 sheet 的内容
• 通过名称读取特定 sheet 的内容
• 通过索引读取特定 sheet 的内容
• 以 JSON 格式返回数据
• 处理空单元格和数据类型转换

安装

需要 Python 3.10 或更高版本。

# 使用 pip
pip install excel-reader-server

# 使用 uv (推荐)
uv pip install excel-reader-server

依赖

• mcp >= 1.2.1
• openpyxl >= 3.1.5

使用方法

服务器提供三个主要工具：

1. read_excel

读取 Excel 文件中所有 sheet 的内容。

{
  "file_path": "path/to/your/excel/file.xlsx"
}

2. read_excel_by_sheet_name

通过名称读取特定 sheet 的内容。 如果未提供 sheet 名称，则读取第一个 sheet。

{
  "file_path": "path/to/your/excel/file.xlsx",
  "sheet_name": "Sheet1"  # 可选
}

3. read_excel_by_sheet_index

通过索引读取特定 sheet 的内容。 如果未提供索引，则读取第一个 sheet（索引 0）。

{
  "file_path": "path/to/your/excel/file.xlsx",
  "sheet_index": 0  # 可选
}

响应格式

服务器以以下 JSON 格式返回数据：

{
  "Sheet1": [
    ["Header1", "Header2", "Header3"],
    ["Value1", "Value2", "Value3"],
    ["Value4", "Value5", "Value6"]
  ]
}

• 每个 sheet 表示为顶级对象中的一个键
• Sheet 数据是一个数组的数组，其中每个内部数组表示一行
• 所有值都转换为字符串
• 空单元格表示为空字符串

错误处理

服务器为常见问题提供清晰的错误消息：

• 文件未找到
• 无效的 sheet 名称
• 索引超出范围
• 常规 Excel 文件读取错误

许可证

本项目根据 MIT 许可证发布。 有关详细信息，请参见 LICENSE 文件。

贡献

欢迎贡献！ 请随时提交 Pull Request。