Excel MCP Server Bachstudio

](https://pypi.org/project/excel-mcp-server/) ](https://pepy.tech/project/excel-mcp-server)  ](https://smithery.ai/server/@haris-musa/excel-mcp-server) 

一种模型上下文协议（MCP）服务器，允许您在不安装Microsoft Excel的情况下操作Excel文件。使用AI代理创建、读取和修改Excel工作簿。

特性

• 📊 Excel操作：创建、阅读、更新工作簿和工作表
• 📈 数据操作：公式、格式、图表、透视表和Excel表
• 🔍 数据验证：内置范围、公式和数据完整性验证
• 🎨 格式化：字体样式、颜色、边框、对齐方式和条件格式
• 📋 表操作：使用自定义样式创建和管理Excel表
• 📊 图表创建：生成各种图表类型（折线图、条形图、饼图、散点图等）
• 🔄 数据透视表：为数据分析创建动态透视表
• 🔧 表单管理：轻松复制、重命名、删除工作表
• 🔌 三重运输支持：stdio、SSE（已弃用）和可流式传输的HTTP
• 🌐 远程和本地：既可在本地运行，也可作为远程服务运行

安装

# 使用 pip 安装
pip install excel-mcp-server-bachstudio

# 或使用 uvx（推荐）
uvx excel-mcp-server-bachstudio stdio

如果遇到模块导入错误

如果使用 uvx 时遇到 ModuleNotFoundError，请清除 uvx 缓存：

# 清除 uv 缓存
uv cache clean

# 或指定清除特定包
uv cache clean excel-mcp-server-bachstudio

用法

服务器支持三种传输方式：

1.标准运输（供当地使用）

uvx excel-mcp-server-bachstudio stdio

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

2.SSE传输（服务器发送事件-已弃用）

uvx excel-mcp-server-bachstudio sse

SSE传输连接:

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

3.流式HTTP传输（建议用于远程连接）

uvx excel-mcp-server-bachstudio 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-bachstudio streamable-http

• 示例（Linux/macOS）：

  EXCEL_FILES_PATH=/path/to/excel_files FASTMCP_PORT=8007 uvx excel-mcp-server-bachstudio streamable-http

标准运输

使用时 stdio协议，文件路径随每个工具调用提供，因此您可以 不 需要设置 EXCEL_FILES_PATH 在服务器上。服务器将使用客户端为每个操作发送的路径。

可用工具

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

鸣谢

本项目基于原项目修改：haris musa/excel mcp服务器

许可证

MIT许可证-请参阅 许可证 了解详情。