article
README
🚀 Excel MCP 服务器
Excel MCP 服务器是一个模型上下文协议(MCP)服务器,无需安装 Microsoft Excel 即可操作 Excel 文件。它支持创建、读取和修改 Excel 工作簿,可与 AI 代理协同使用,为用户提供便捷的 Excel 操作体验。
🚀 快速开始
先决条件
- Python 3.10 或更高版本
📦 安装指南
- 克隆仓库:
git clone https://github.com/haris-musa/excel-mcp-server.git
cd excel-mcp-server
- 使用 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
✨ 主要特性
- 📊 创建和修改 Excel 工作簿
- 📝 读取和写入数据
- 🎨 应用格式和样式
- 📈 创建图表和可视化
- 📊 生成透视表
- 🔄 管理工作表和范围
💻 使用示例
与 AI 工具一起使用
Cursor IDE
- 将以下配置添加到 Cursor:
{
"mcpServers": {
"excel": {
"url": "http://localhost:8000/sse",
"env": {
"EXCEL_FILES_PATH": "/path/to/excel/files"
}
}
}
}
- Excel 工具将通过您的 AI 助手提供。
远程托管 & 传输协议
此服务器使用 Server-Sent Events(SSE)传输协议。针对不同用例:
- 与 Claude Desktop 使用(需要 stdio):
- 使用 Supergateway 将 SSE 转换为 stdio。
- 托管您的 MCP 服务器:
📚 详细文档
环境变量
| 属性 | 详情 |
|------|------|
| FASTMCP_PORT | 服务器端口(默认:8000) |
| EXCEL_FILES_PATH | Excel 文件目录(默认:./excel_files) |
可用工具
该服务器提供全面的 Excel 操作工具。有关所有可用工具的完整文档,请参阅 TOOLS.md。
📄 许可证
本项目采用 MIT 许可证,详见 LICENSE 了解详细信息。
扫码联系在线客服