Excel MCP 服务器

一个模型上下文协议 (MCP) 服务器的实现，提供 Excel 文件操作功能，无需安装 Microsoft Excel。 该服务器支持工作簿创建、数据操作、格式设置和高级 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 文件。