Excel MCP Server

一个模型上下文协议（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:8
000/sse",
      "env": {
        "EXCEL_FILES_PATH": "/path/to/excel/files"
      }
    }
  }
}

2. 您可以通过AI助手访问Excel工具。

远程托管及传输协议

该服务器使用服务发送事件（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。 </中文翻译>