Excel Reader Server

基本能力

产品定位

Excel Reader Server 是一个专门用于读取 Excel 文件数据的 MCP 服务，旨在简化 Excel 文件的数据提取和处理流程。

核心功能

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

适用场景

• 数据分析：快速提取 Excel 文件中的数据进行分析
• 数据转换：将 Excel 数据转换为 JSON 格式以便于其他系统使用
• 数据集成：将 Excel 数据集成到其他应用程序或服务中

工具列表

1. read_excel：读取 Excel 文件中所有工作表的内容。
2. read_excel_by_sheet_name：通过工作表名称读取特定工作表的内容。
3. read_excel_by_sheet_index：通过工作表索引读取特定工作表的内容。

常见问题解答

• 文件未找到：确保提供的文件路径正确。
• 无效的工作表名称：检查工作表名称是否拼写正确。
• 索引超出范围：确保提供的工作表索引在有效范围内。
• Excel 文件读取错误：检查文件是否损坏或格式是否正确。

使用教程

使用依赖

• Python 3.10 或更高版本
• mcp >= 1.2.1
• openpyxl >= 3.1.5

安装教程

# 使用 pip 安装
pip install excel-reader-server

# 使用 uv 安装（推荐）
uv pip install excel-reader-server

调试方式

安装完成后，可以通过以下命令测试服务是否正常运行：

# 启动服务
mcp-server

# 使用 curl 测试服务
curl -X POST http://localhost:8080/read_excel -d '{"file_path": "path/to/your/excel/file.xlsx"}'

许可证

该项目遵循 MIT 开源许可条款。