haris-musa/excel-mcp-server

一个模型上下文协议（MCP）服务器，让您无需安装Microsoft Excel即可操作Excel文件。使用您的AI代理创建、读取和修改Excel工作簿。

功能

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

使用方法

服务器支持三种传输方法：

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

uvx excel-mcp-server stdio

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

2. SSE传输（服务器发送事件 - 已弃用）

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环境变量来控制服务器监听的端口（如果未设置，默认为8000）。

• 示例（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。