Excel MCP 服务器

一个模型上下文协议 (MCP) 服务器，让您无需安装 Microsoft Excel 即可操作 Excel 文件。使用您的 AI 代理创建、读取和修改 Excel 工作簿。

功能

• 📊 创建和修改 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 助手提供。

远程托管和传输协议

此服务器使用服务器发送事件 (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。