Excel Reader Server
2025.04.02
3
PythonExcel 数据处理数据转换开发效率
Excel Reader Server 是一个基于 Model Context Protocol (MCP) 的服务，专门用于读取 Excel (xlsx) 文件的内容。它提供了多种读取方式，包括读取所有工作表、按名称读取特定工作表或按索引读取特定工作表，并将数据以 JSON 格式返回。该服务适用于需要处理 Excel 文件数据的各种场景，如数据分析、数据转换和自动化任务等。
View on GitHub
Overview
基本能力
产品定位
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
安装教程
# 使用 pip 安装
pip install excel-reader-server
# 使用 uv 安装（推荐）
uv pip install excel-reader-server
调试方式
安装完成后，可以通过以下命令测试服务是否正常运行：
# 运行服务并测试读取 Excel 文件
mcp run excel-reader-server
响应格式
服务返回的数据格式如下：
{
"Sheet1": [
["Header1", "Header2", "Header3"],
["Value1", "Value2", "Value3"],
["Value4", "Value5", "Value6"]
]
}
- 每个工作表作为顶级对象的键
- 工作表数据是一个数组的数组，每个内部数组代表一行
- 所有值都转换为字符串
- 空单元格表示为空字符串