Excel MCP Server Xlwings

     基于 Model Context Protocol (MCP) 的 Excel 操作服务端，支持对 Excel 文件进行实时编辑。本服务端基于 xlwings，可直接连接本地已打开的 Excel 实例，在 Excel 窗口中即时查看修改结果。

环境要求

• Microsoft Excel（Windows 或 macOS）——xlwings 运行所必需
• Python >= 3.10
• Windows：需已安装 Excel，并可通过 COM 访问
• macOS：需已安装 Excel，并可通过 AppleScript 访问

功能特性

• 📊 实时编辑：在 Excel 文件打开状态下编辑，修改即时可见
• 📈 数据操作：公式、格式、图表、数据透视表、Excel 表格
• 🔍 数据验证：内置对区域、公式及数据完整性的验证
• 🎨 格式设置：字体、颜色、边框、对齐、条件格式等
• 📋 表格操作：创建与管理 Excel 表格，支持自定义样式
• 📊 图表创建：支持折线图、柱状图、饼图、散点图等多种图表
• 🔄 数据透视表：创建动态数据透视表进行数据分析
• 🔧 工作表管理：复制、重命名、删除工作表
• 🔌 多种传输方式：stdio、SSE（已弃用）、可流式 HTTP
• 🌐 本地与远程：支持本地运行或作为远程服务
• ⚡ 实时连接：连接已打开的 Excel 文件，无需先关闭

使用方式

服务端支持三种传输方式：

1. Stdio 传输（本地使用）

uvx excel-mcp-server stdio

在 MCP 客户端中配置示例：

{
   "mcpServers": {
      "excel": {
         "command": "uvx",
         "args": ["excel-mcp-server", "stdio"]
      }
   }
}

2. SSE 传输（Server-Sent Events，已弃用）

uvx excel-mcp-server sse

SSE 连接配置示例：

{
   "mcpServers": {
      "excel": {
         "url": "http://localhost:8000/sse",
      }
   }
}

3. 可流式 HTTP 传输（推荐用于远程连接）

uvx excel-mcp-server streamable-http

可流式 HTTP 连接配置示例：

{
   "mcpServers": {
      "excel": {
         "url": "http://localhost:8000/mcp",
      }
   }
}

环境变量与文件路径

SSE 与可流式 HTTP 传输

使用 SSE 或可流式 HTTP 时，必须在服务端设置环境变量 EXCEL_FILES_PATH，用于指定 Excel 文件的读写目录。

• 未设置时，默认为 ./excel_files。

可通过 FASTMCP_PORT 指定服务端监听端口（未设置时默认为 8017）。

• Windows PowerShell 示例：

  $env:EXCEL_FILES_PATH="E:\MyExcelFiles"
  $env:FASTMCP_PORT="8007"
  uvx excel-mcp-server streamable-http

• Linux / macOS 示例：

  EXCEL_FILES_PATH=/path/to/excel_files FASTMCP_PORT=8007 uvx excel-mcp-server streamable-http

Stdio 传输

使用 stdio 时，文件路径由每次工具调用时传入，无需在服务端设置 EXCEL_FILES_PATH，服务端会使用客户端提供的路径。

可用工具

服务端提供完整的 Excel 操作工具集，完整说明见 TOOLS.md。

主要能力包括：

• 工作簿：创建、获取元数据
• 工作表：创建、复制、重命名、删除、列表
• 数据：读取、写入、公式、验证
• 格式：字体、颜色、边框、对齐、条件格式、合并单元格
• 范围：复制、删除、验证
• 行列：插入/删除行与列
• 表格：创建 Excel 表格
• 图表：创建、列表、删除、样式
• 数据透视表：创建
• VBA：在 Excel 文件上执行 VBA 代码（含安全与备份说明）

使用 VBA 功能前：请在 Excel 中开启对 VBA 工程对象模型的信任，否则会报「安全检查失败」。操作：文件 → 选项 → 信任中心 → 信任中心设置 → 宏设置，勾选 「信任对 VBA 工程对象模型的访问」。

许可证

MIT License，详见 LICENSE。