🚀 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：
- 实时编辑 MS 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"
}
}
}
}
通过 Smithery 安装
要自动为 Claude Desktop 安装 Excel MCP Server，请通过 Smithery：
npx -y @smithery/cli install @negokaz/excel-mcp-server --client claude
📚 详细文档
要求
- Node.js 20.x 或更高版本
支持的文件格式
- xlsx（Excel 工作簿）
- xlsm（带宏的 Excel 工作簿）
- xltx（Excel 模板）
- xltm（带宏的 Excel 模板）
工具
read_sheet_names
列出 Excel 文件中的所有工作表名称。
参数：
fileAbsolutePath：Excel 文件的绝对路径
read_sheet_data
按分页读取 Excel 工作表的数据。
参数：
fileAbsolutePath：Excel 文件的绝对路径sheetName：Excel 文件中的工作表名称range：要读取的 Excel 工作表范围（例如："A1:B2"）。默认情况下，如果未指定范围，则从第一个单元格开始按分页读取。
read_sheet_data_with_range
按分页读取 Excel 工作表中指定范围的数据。
参数：
fileAbsolutePath：Excel 文件的绝对路径sheetName：Excel 文件中的工作表名称startRow：要读取的起始行号endRow：要读取的结束行号- 每次最多读取 4000 个单元格。
read_sheet_formula
按分页读取 Excel 工作表中的公式。
参数：
fileAbsolutePath：Excel 文件的绝对路径sheetName：Excel 文件中的工作表名称
write_sheet_data
将数据写入 Excel 工作表。
参数：
fileAbsolutePath：Excel 文件的绝对路径sheetName：Excel 文件中的工作表名称data：要写入的数据（例如：{A1: "value"}）
write_sheet_formula
将公式写入 Excel 工作表。
参数：
fileAbsolutePath：Excel 文件的绝对路径sheetName：Excel 文件中的工作表名称formula：要写入的公式（例如：{A1: "=A2+B2"}）
配置
你可以通过以下环境变量更改 MCP 服务器的行为：
EXCEL_MCP_PAGING_CELLS_LIMIT
每次分页操作中读取的最大单元格数。[默认值：4000]
📄 许可证
版权所有 (c) 2025 Kazuki Negoro
excel-mcp-server 按照 MIT License 发布