🚀 Excel MCP 服务端
一个基于 Model Context Protocol (MCP) 的服务端实现，无需安装 Microsoft Excel 即可操作 Excel 文件，支持工作簿创建、数据处理、格式设置等高级功能。
🚀 快速开始
环境配置
服务端可以通过以下环境变量进行配置：
EXCEL_FILES_PATH：存储 Excel 文件的目录（默认：./excel_files）
您可以通过以下方式设置：
- Windows CMD：
set EXCEL_FILES_PATH=C:\path\to\excel\files
uv run excel-mcp-server
- Windows PowerShell：
$env:EXCEL_FILES_PATH="C:\path\to\excel\files"
uv run excel-mcp-server
- Linux/MacOS：
export EXCEL_FILES_PATH=/path/to/excel/files
uv run excel-mcp-server
- Claude Desktop 配置：
{
"mcpServers": {
"excel": {
"command": "uv run excel-mcp-server",
"transport": "sse",
"env": {
"EXCEL_FILES_PATH": "/path/to/excel/files"
}
}
}
}
启动服务端
启动服务端：
uv run excel-mcp-server
服务端将以 SSE 模式启动并等待来自 MCP 客户端的连接。
在 Cursor IDE 中连接
启动服务端后，在 Cursor IDE 中连接到 SSE 终点：
http://localhost:8000/sse
Excel MCP 工具将在代理中可用。有关可用工具及其用法，请参阅 TOOLS.md。
✨ 主要特性
- 完整的 Excel 支持：提供全面的 Excel 功能。
- 数据操作：支持读取、写入和转换数据。
- 高级功能：涵盖图表、数据透视表和格式设置。
- 错误处理：具备全面的错误处理和清晰的消息提示。
📦 安装指南
要求
- Python 3.10+
- MCP SDK 1.2.0+
- OpenPyXL 3.1.2+
💻 使用示例
基础用法
在不同系统环境下配置 EXCEL_FILES_PATH 并启动服务端：
# Windows CMD
set EXCEL_FILES_PATH=C:\path\to\excel\files
uv run excel-mcp-server
# Windows PowerShell
$env:EXCEL_FILES_PATH="C:\path\to\excel\files"
uv run excel-mcp-server
# Linux/MacOS
export EXCEL_FILES_PATH=/path/to/excel/files
uv run excel-mcp-server
高级用法
在 Claude Desktop 配置中设置服务端环境变量：
{
"mcpServers": {
"excel": {
"command": "uv run excel-mcp-server",
"transport": "sse",
"env": {
"EXCEL_FILES_PATH": "/path/to/excel/files"
}
}
}
}
📚 详细文档
组件
资源
该服务端通过 OpenPyXL 提供 Excel 工作簿操作功能：
- 创建和修改 Excel 工作簿
- 管理工作表和范围
- 处理格式设置和样式
- 支持图表和数据透视表
工具
此服务端提供全面的 Excel 操作工具。有关所有可用工具、参数和使用示例的详细文档，请参阅 TOOLS.md。 工具包括以下功能：
- 工作簿和工作表管理
- 数据读取和写入
- 格式设置和样式处理
- 图表和可视化
- 数据透视表和数据分析
请参考 TOOLS.md 了解完整文档。
📄 许可证
此项目在 MIT License 下许可 - 请查看 LICENSE 文件以获取详细信息。