返回市场
excel-mcp-服务器

excel-mcp-服务器

作者:haris-musa2849 星标更新:2025-08-11

项目介绍

<p align="center"> <img src="https://gips1.baidu.com/it/u=289659214,2100259400&fm=3081&app=3081&f=PNG?w=400&h=100" alt="Excel MCP Server Logo" width="300"/> </p>

PyPI 版本 总下载量 许可证: MIT smithery 徽章 安装 MCP 服务器

这是一个模型上下文协议(MCP)服务器,它允许您在无需安装Microsoft Excel的情况下操作Excel文件。您可以创建、读取和修改Excel工作簿。

功能

  • 📊 Excel 操作: 创建、读取、更新工作簿和工作表
  • 📈 数据操作: 公式、格式化、图表、透视表和Excel表格
  • 🔍 数据验证: 内置的范围、公式和数据完整性验证
  • 🎨 格式化: 字体样式、颜色、边框、对齐方式和条件格式
  • 📋 表格操作: 创建并管理具有自定义样式的Excel表格
  • 📊 图表生成: 生成各种类型的图表(折线图、柱状图、饼图、散点图等)
  • 🔄 透视表: 创建动态透视表进行数据分析
  • 🔧 工作表管理: 轻松复制、重命名、删除工作表
  • 🔌 三重传输支持: 标准输入输出(stdio)、服务发送事件(SSE,已弃用)和可流式传输HTTP
  • 🌐 远程与本地: 既可以在本地运行,也可以作为远程服务运行

使用方法

该服务器支持三种传输方法:

1. 标准输入输出传输(用于本地使用)

uvx excel-mcp-server stdio
{
   "mcpServers": {
      "excel": {
         "command": "uvx",
         "args": ["excel-mcp-server", "stdio"]
      }
   }
}

2. 服务发送事件传输(SSE,已弃用)

uvx excel-mcp-server sse

SSE 传输连接

{
   "mcpServers": {
      "excel": {
         "url": "http://localhost:8000/sse",
      }
   }
}

3. 可流式传输HTTP传输(推荐用于远程连接)

uvx excel-mcp-server streamable-http

可流式传输HTTP传输连接

{
   "mcpServers": {
      "excel": {
         "url": "http://localhost:8000/mcp",
      }
   }
}

环境变量及文件路径处理

SSE 和可流式传输HTTP传输

当使用 SSE 或可流式传输HTTP协议 运行服务器时,必须在服务器端设置 EXCEL_FILES_PATH 环境变量。此变量告诉服务器在哪里读写Excel文件。

  • 如果未设置,默认为 ./excel_files

您还可以设置 FASTMCP_PORT 环境变量来控制服务器监听的端口(如果未设置,默认为 8017)。

  • 示例(Windows PowerShell):
    $env:EXCEL_FILES_PATH="E:\MyExcelFiles"
    $env:FASTMCP_PORT="8007"
    uvx excel-mcp-server streamable-http
    
  • 示例(Linux/macOS):
    EXCEL_FILES_PATH=/path/to/excel_files FASTMCP_PORT=8007 uvx excel-mcp-server streamable-http
    

标准输入输出传输

当使用 标准输入输出协议 时,文件路径是随每个工具调用提供的,因此您不需要在服务器上设置 EXCEL_FILES_PATH。服务器将使用客户端发送的路径进行每次操作。

可用工具

该服务器提供了一整套Excel操作工具。请参阅 TOOLS.md 获取所有可用工具的完整文档。

星标历史

星标历史图表

许可证

MIT 许可证 - 详情见 LICENSE