excel-mcp-server

一个 Model Context Protocol (MCP) 服务器，让你无需安装 Microsoft Excel 即可操作 Excel 文件。你可以通过 AI 代理创建、读取和修改 Excel 工作簿。

功能特性

• 📊 Excel 操作：创建、读取、更新工作簿和工作表
• 📈 数据处理：公式、格式化、图表、数据透视表和 Excel 表格
• 🔍 数据验证：内置对区域、公式和数据完整性的验证
• 🎨 格式化：字体样式、颜色、边框、对齐和条件格式
• 📋 表格操作：创建和管理具有自定义样式的 Excel 表格
• 📊 图表创建：生成各种图表类型（折线图、柱状图、饼图、散点图等）
• 🔄 数据透视表：创建用于数据分析的动态数据透视表
• 🔧 工作表管理：轻松复制、重命名、删除工作表
• 🔌 三种传输支持：stdio、SSE（已弃用）和 streamable HTTP
• 🌐 远程与本地：既可在本地运行，也可作为远程服务运行

使用方法

该服务器支持三种传输方式：

1. Stdio 传输（用于本地使用）

uvx excel-mcp-server stdio

{
   "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. Streamable HTTP 传输（推荐用于远程连接）

uvx excel-mcp-server streamable-http

Streamable HTTP 传输连接：

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

环境变量与文件路径处理

SSE 和 Streamable HTTP 传输

当使用 SSE 或 Streamable HTTP 协议运行服务器时，你必须在服务器端设置 EXCEL_FILES_PATH 环境变量。该变量告诉服务器在哪里读取和写入 Excel 文件。

• 如果未设置，则默认为 ./excel_files。
• 使用这些传输方式时，工具的 filepath 值必须相对于该目录（例如 reports/q1.xlsx）；绝对路径和目录遍历将被拒绝。

你还可以设置 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。

Star 历史

许可证

MIT 许可证 - 详见 LICENSE。