Excel 阅读器服务器

提供读取 Excel (xlsx) 文件工具的模型上下文协议 (MCP) 服务器。

特征

• 读取 Excel 文件中所有工作表的内容

• 按名称读取特定工作表中的内容

• 通过索引读取特定工作表中的内容

• 以 JSON 格式返回数据

• 处理空单元格和数据类型转换

Related MCP server: Excel MCP Server

安装

需要 Python 3.10 或更高版本。

# Using pip
pip install excel-reader-server

# Using uv (recommended)
uv pip install excel-reader-server

依赖项

• mcp >= 1.2.1

• openpyxl >= 3.1.5

用法

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

1. 读取 Excel

读取 Excel 文件中所有工作表的内容。

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

2. 通过工作表名称读取 Excel

根据名称从特定工作表读取内容。如果未提供工作表名称，则读取第一个工作表。

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

3. 通过工作表索引读取 Excel

根据索引从特定工作表读取内容。如果未提供索引，则读取第一个工作表（索引 0）。

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

响应格式

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

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

• 每个工作表都表示为顶级对象中的一个键

• 工作表数据是一个数组数组，其中每个内部数组代表一行

• 所有值都转换为字符串

• 空单元格表示为空字符串

错误处理

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

• 未找到文件

• 工作表名称无效

• 索引超出范围

• 常见 Excel 文件读取错误

执照

本项目遵循 Apache 2 许可证。详情请参阅许可证文件。

贡献

欢迎贡献代码！欢迎提交 Pull 请求。