Excel文件处理服务

一个跨平台的Excel文件读写和格式化服务,支持实时操作打开的Excel工作簿和直接编辑关闭的.xlsx文件。

  • by kousunh
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 kousunh/Excel-mcp-server

使用说明

日本语README

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在工作簿打开的情况下运行。

许可证

麻省理工学院