使用说明
Excel MCP服务器
用于读取、写入和格式化Excel文件的跨平台MCP服务器。适用于打开的Excel工作簿(实时)和关闭的.xlsx文件(不需要Excel)。
两种模式
workbook--通过xlwings实时操作打开的Excel工作簿path--使用纯Python直接编辑已关闭的.xlsx文件(保留图像、图表和所有嵌入内容)
工具
| 工具 | 工作簿 | 路径 | 必填 |
|---|---|---|---|
get_excel_info |
- | - | (无) |
read_cells |
OK | OK | 范围 |
write_cells |
OK | OK | 范围,值 |
format_cells |
OK | OK | 范围、格式 |
execute_vba |
确定 | - | 工作簿,代码 |
需求
- Node.js 18+
- python 3.8+
- xlwings (适用于实时Excel模式--
pip install xlwings) - 微软Excel (只需要
workbook模式和execute_vba)
工作在 视窗 和 macOSThe path 模式也适用于Linux。
安装
git clone https://github.com/kousunh/excel-mcp-server.git
cd excel-mcp-server
npm install
pip install -r scripts/requirements.txt
配置MCP客户端
添加到您的MCP客户端配置(Claude Desktop、Cursor等):
{
"mcpServers": {
"excel-mcp": {
"command": "node",
"args": ["/path/to/excel-mcp-server/src/index.js"]
}
}
}
要使用特定的Python可执行文件,请设置 EXCEL_MCP_PYTHON 环境变量:
{
"mcpServers": {
"excel-mcp": {
"command": "node",
"args": ["/path/to/excel-mcp-server/src/index.js"],
"env": {
"EXCEL_MCP_PYTHON": "/path/to/python"
}
}
}
}
用法
关闭文件(路径模式)
read_cells path="/data/report.xlsx" range="A1:D20" formats=true
write_cells path="/data/report.xlsx" range="A1:C3" value=[["Name","Age","City"],["Alice",30,"NYC"],["Bob",25,"LA"]]
format_cells path="/data/report.xlsx" range="A1:C1" format={"bold":true,"backgroundColor":"#4472C4","fontColor":"#FFFFFF"}
无需安装Excel。图像、图表和形状得以保留。
打开工作簿(工作簿模式)
get_excel_info
read_cells workbook="Sales.xlsx" range="B2:F10"
write_cells workbook="Sales.xlsx" range="G2" value="=SUM(B2:F2)"
execute_vba workbook="Sales.xlsx" code="Range(\"A1:G10\").AutoFilter"
要求Excel在工作簿打开的情况下运行。
许可证
麻省理工学院
