🚀 Excel MCP 服务端

一个基于 Model Context Protocol (MCP) 的服务端实现，无需安装 Microsoft 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。

✨ 主要特性

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

📦 安装指南

要求

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

💻 使用示例

基础用法

在不同系统环境下配置 EXCEL_FILES_PATH 并启动服务端：

# 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"
      }
    }
  }
}

📚 详细文档

组件

资源

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

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

工具

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

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

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

📄 许可证

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