Excel读取服务器

Excel阅读器服务器

一种模型上下文协议（MCP）服务器，提供读取Excel（xlsx）文件的工具。

特性

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

安装

需要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.read_excel

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

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

2.read_excel_by_sheet_name

按名称从特定工作表中读取内容。如果没有提供图纸名称，则读取第一张图纸。

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

3.read_excel_by_sheet_index

按索引从特定工作表中读取内容。如果没有提供索引，则读取第一张纸（索引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许可证下发布。有关详细信息，请参阅LICENSE文件。

贡献

欢迎投稿！请随时提交拉取请求。