🚀 Excel MCP 服务器
一个支持 Model Context Protocol (MCP) 的服务器，用于读取和写入 Microsoft Excel 数据，为 Excel 数据处理提供便捷方案。
🚀 快速开始
Excel MCP 服务器是一个支持 Model Context Protocol (MCP) 的服务器，可用于读取和写入 Microsoft Excel 数据。
✨ 主要特性
- 从 MS Excel 文件中读取文本值
- 向 MS Excel 文件中写入文本值
- 从 MS Excel 文件中读取公式
- 向 MS Excel 文件中写入公式
- 捕获文件的屏幕图像（仅限 Windows）
更多细节请参见工具部分。
📦 安装指南
系统要求
- Node.js 20.x 或更高版本
支持的文件格式
- xlsx（Excel 工作簿）
- xlsm（带宏的 Excel 工作簿）
- xltx（Excel 模板）
- xltm（带宏的 Excel 模板）
安装方法
通过 NPM 安装
要自动安装 Excel MCP Server，请在 MCP 服务器配置中添加以下内容。
对于 Windows：
{
"mcpServers": {
"excel": {
"command": "cmd",
"args": ["/c", "npx", "--yes", "@negokaz/excel-mcp-server"],
"env": {
"EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
}
}
}
}
对于其他平台：
{
"mcpServers": {
"excel": {
"command": "npx",
"args": ["--yes", "@negokaz/excel-mcp-server"],
"env": {
"EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
}
}
}
}
通过史密瑟里安装
要自动为 Claude Desktop 安装 Excel MCP Server，请使用 史密瑟里：
npx -y @smithery/cli install @negokaz/excel-mcp-server --client claude
📚 详细文档
read_sheet_names
列出 Excel 文件中的所有工作表名称。
参数：
fileAbsolutePath- Excel 文件的绝对路径
read_sheet_data
按分页读取 Excel 工作表的数据。
参数：
fileAbsolutePath- Excel 文件的绝对路径
sheetName- Excel 文件中的工作表名称
range（可选）- 读取的范围，格式为 "A1:B2"。
- 默认值：整个工作表
returnHeaders（可选）- 是否返回列标题，默认为 true。
read_sheet_data_all
按分页读取 Excel 文件中所有工作表的数据。
参数：
fileAbsolutePath- Excel 文件的绝对路径
write_sheet_data
向 Excel 工作表写入数据。
参数：
fileAbsolutePath- Excel 文件的绝对路径
sheetName- 要写入的工作表名称
data- 要写入的数据，格式为 {row: number, column: string, value: any}
headers（可选）- 是否在第一行添加标题，默认为 true。
write_sheet_data_all
向 Excel 文件中的所有工作表写入数据。
参数：
fileAbsolutePath- Excel 文件的绝对路径
配置环境变量
通过以下环境变量调整 MCP 服务器的行为：
EXCEL_MCP_PAGING_CELLS_LIMIT
每次分页操作中读取的最大单元格数。
[默认值：4000]
📄 许可证
版权所有 (c) 2025 Kazuki Negoro
Excel MCP Server 根据 MIT License 发布