Excel MCP 服务器

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

特性

• 📊 创建和修改 Excel 工作簿
• 📝 读取和写入数据
• 🎨 应用格式和样式
• 📈 创建图表和可视化
• 📊 生成透视表
• 🔄 管理工作表和范围

快速入门

决条件

• Python 3.10 或更高版本

安装

1. 克隆仓库：

git clone https://github.com/haris-musa/excel-mcp-server.git
cd excel-mcp-server

2. 使用 uv 进行安装：

uv pip install -e .

运行服务器

启动服务器（默认端口 8000）：

uv run excel-mcp-server

自定义端口（例如，8080）：

# Bash/Linux/macOS
export FASTMCP_PORT=8080 && uv run excel-mcp-server

# Windows PowerShell
$env:FASTMCP_PORT = "8080"; uv run excel-mcp-server

与 AI 工具一起使用

Cursor IDE

1. 将以下配置添加到 Cursor：

{
  "mcpServers": {
    "excel": {
      "url": "http://localhost:8000/sse",
      "env": {
        "EXCEL_FILES_PATH": "/path/to/excel/files"
      }
    }
  }
}

2. Excel 工具将通过您的 AI 助手提供。

远程托管 & 传输协议

此服务器使用 Server-Sent Events (SSE) 传输协议。针对不同用例：

1. 与 Claude Desktop 使用（需要 stdio）：

   • 使用 Supergateway 将 SSE 转换为 stdio：

2. 托管您的 MCP 服务器：

   • 远程 MCP 服务器指南

环境变量

• FASTMCP_PORT：服务器端口（默认：8000）
• EXCEL_FILES_PATH：Excel 文件目录（默认：./excel_files）

可用工具

该服务器提供全面的 Excel 操作工具。有关所有可用工具的完整文档，请参阅 TOOLS.md。

许可证

MIT License - 详细信息请查看 LICENSE。