Excel MCP 服务器

这是一个 Model Context Protocol (MCP) 服务器实现，提供了无需安装 Microsoft Excel 即可操作 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 文件。