Excel MCP 服务端

一个 Model Context Protocol (MCP) 服务端实现，提供无需安装 Microsoft Excel 的 Excel 文件操作功能。此服务端支持工作簿创建、数据 manipulation、格式设置以及高级 Excel 功能。

要求

• Python 3.10+
• MCP SDK 1.2.0+
• OpenPyXL 3.1.2+

组件

资源

该服务端通过 OpenPyXL 提供 Excel 工作簿操作功能：

• 创建和修改 Excel 工作簿
• 管理工作表和范围
• 处理格式设置和样式
• 支持图表和数据透视表

工具

此服务端提供全面的 Excel 操作工具。有关所有可用工具、参数和使用示例的详细文档，请参阅 TOOLS.md。

工具包括以下功能：

• 工作簿和工作表管理
• 数据读取和写入
• 格式设置和样式处理
• 图表和可视化
• 数据透视表和数据分析

请参考 TOOLS.md 了解完整文档。

功能

• 完整的 Excel 支持：全面的 Excel 功能
• 数据操作：读取、写入和转换数据
• 高级功能：图表、数据透视表和格式设置
• 错误处理：全面的错误处理和清晰的消息

使用说明

环境配置

服务端可以通过以下环境变量进行配置：

• EXCEL_FILES_PATH：存储 Excel 文件的目录（默认：./excel_files）

您可以通过以下方式设置：

Windows CMD:

set EXCEL_FILES_PATH=C:\path\to\excel\files
uv run excel-mcp-server

Windows PowerShell:

$env:EXCEL_FILES_PATH="C:\path\to\excel\files"
uv run excel-mcp-server

Linux/MacOS:

export EXCEL_FILES_PATH=/path/to/excel/files
uv run excel-mcp-server

或者在 Claude Desktop 配置中：

{
  "mcpServers": {
    "excel": {
      "command": "uv run excel-mcp-server",
      "transport": "sse",
      "env": {
        "EXCEL_FILES_PATH": "/path/to/excel/files"
      }
    }
  }
}

启动服务端

启动服务端：

uv run excel-mcp-server

服务端将以 SSE 模式启动并等待来自 MCP 客户端的连接。

在 Cursor IDE 中连接

启动服务端后，在 Cursor IDE 中连接到 SSE 终点：

http://localhost:8000/sse

Excel MCP 工具将在代理中可用。有关可用工具及其用法，请参阅 TOOLS.md。

许可证

此项目在 MIT License 下许可 - 请查看 LICENSE 文件以获取详细信息。