基本能力
产品定位
Excel Reader Server 是一个专门用于读取 Excel 文件内容的 MCP 服务,旨在简化 Excel 文件的数据提取和处理流程。
核心功能
- 读取 Excel 文件中所有工作表的内容
- 按名称读取特定工作表的内容
- 按索引读取特定工作表的内容
- 返回 JSON 格式的数据
- 处理空单元格和数据类型转换
适用场景
- 数据分析:快速提取 Excel 数据进行分析
- 数据转换:将 Excel 数据转换为 JSON 格式以便后续处理
- 自动化任务:集成到自动化流程中,自动读取和处理 Excel 文件
工具列表
- read_excel:读取所有工作表的内容。
- read_excel_by_sheet_name:按名称读取特定工作表的内容。
- read_excel_by_sheet_index:按索引读取特定工作表的内容。
常见问题解答
- 文件未找到:确保提供的文件路径正确。
- 无效的工作表名称:检查工作表名称是否正确。
- 索引超出范围:确保提供的索引在工作表范围内。
- Excel 文件读取错误:检查文件是否损坏或格式不正确。
使用教程
使用依赖
- Python 3.10 或更高版本
- mcp >= 1.2.1
- openpyxl >= 3.1.5
安装教程
```bash
使用 pip 安装
pip install excel-reader-server
使用 uv 安装(推荐)
uv pip install excel-reader-server
```
调试方式
安装完成后,可以通过以下命令测试服务是否正常运行:
```bash
运行服务并测试读取 Excel 文件
mcp run excel-reader-server
```
响应格式
服务返回的数据格式如下:
json
{
"Sheet1": [
["Header1", "Header2", "Header3"],
["Value1", "Value2", "Value3"],
["Value4", "Value5", "Value6"]
]
}
- 每个工作表作为顶级对象的键
- 工作表数据是一个数组的数组,每个内部数组代表一行
- 所有值都转换为字符串
- 空单元格表示为空字符串