Excel MCP Server Logo

Excel MCP Server

一个模型上下文协议（MCP）服务器，允许你在无需安装 Microsoft Excel 的情况下操作 Excel 文件。通过你的 AI 代理创建、读取和修改 Excel 工作簿。

功能

📊 创建和修改 Excel 工作簿
📝 读取和写入数据
🎨 应用格式和样式
📈 创建图表和可视化
📊 生成数据透视表
🔄 管理工作表和范围
🔌 双重传输支持：stdio 和 SSE

快速开始

先决条件

Python 3.10 或更高版本

运行服务器

服务器支持两种传输模式：stdio 和 SSE。

使用 stdio 传输

Stdio 传输非常适合与 Cursor Desktop 等工具直接集成或本地开发，可以操作本地文件：

uvx excel-mcp-server stdio

使用 SSE 传输

SSE 传输非常适合远程连接，可以操作远程文件：

uvx excel-mcp-server sse

与 AI 工具结合使用

将此配置添加到你的客户端中，根据需求选择合适的传输方法：

Stdio 传输连接（用于本地集成）：

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

SSE 传输连接：

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

Excel 工具将通过你的 AI 助手提供。

环境变量与文件路径处理

SSE 传输

当使用 SSE 协议运行服务器时，必须在服务器端设置 EXCEL_FILES_PATH 环境变量。该变量告诉服务器从哪里读取和写入 Excel 文件。

如果未设置，默认值为 ./excel_files。

你还可以设置 FASTMCP_PORT 环境变量来控制服务器监听的端口（如果未设置，默认值为 8000）。

示例（Windows PowerShell）：

$env:EXCEL_FILES_PATH="E:\MyExcelFiles"
$env:FASTMCP_PORT="8080"
uvx excel-mcp-server sse

示例（Linux/macOS）：

EXCEL_FILES_PATH=/path/to/excel_files FASTMCP_PORT=8080 uvx excel-mcp-server sse

Stdio 传输

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

可用工具

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

星标历史

许可证

MIT 许可证 - 详情请参阅 LICENSE。