Excel MCP 服务器

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

功能

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

快速开始

前提条件

• Python 3.10 或更高版本

安装

1. 克隆仓库： bash git clone https://github.com/Aifornorms/ExcelMCP.git cd ExcelMCP

2. 使用 uv 安装： bash python -m venv .venv .venv/scripts/activate pip install uv uv pip install -e .

运行服务器

启动服务器（默认端口 8000）： bash uv run excel-mcp-server

自定义端口（例如 8080）：

bash

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 中添加此配置： json { "mcpServers": { "excel": { "url": "http://localhost:8000/sse", "env": { "EXCEL_FILES_PATH": "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。