Excel文件操作服务器

一个无需安装Microsoft Excel即可提供Excel文件操作功能的Model Context Protocol (MCP)服务器实现,支持工作簿创建、数据操作、格式化和高级Excel功能。

  • by fish0710
  • Python
  • 混合部署
  • 10 星标
  • 更新于
在 GitHub 查看 fish0710/excel-mcp

使用说明

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许可证获得许可-请参阅 许可证 文件以获取详细信息。