MCP Excel服务器
基于Python的模型上下文协议(MCP)服务器,用于高级Excel文件操作。该项目将Excel文件操作(创建、读取、写入、格式化等)作为MCP资源和工具公开,使其易于自动化和集成Excel工作流。
目录
______________________________________________________________________
项目结构
.
├── advanced_server.py # Advanced MCP server with async support
├── main.py # Main MCP server (FastMCP)
├── excel_fucntion.py # All Excel file manipulation functions
├── requirements.txt # Python dependencies
├── Dockerfile # Docker build for advanced_server.py
├── Docker_advanced.txt # Alternate Dockerfile for advanced_server.py
├── run_local.bat # Windows batch script to run the server
├── run_local.sh # Bash script to run the server
├── .env # Environment variables (e.g., EXCEL_FILES_DIR)
├── excel_files/ # Directory for Excel files (auto-created)
└── __pycache__/ # Python bytecode cache特性
- 列出、创建、重命名和删除Excel文件和工作表
- 读取/写入单元格值、行、列和范围
- 合并/取消合并单元格、设置边框、自动调整列
- 编写公式,另存为新文件
- 所有作为MCP工具/资源公开的操作
- 异步服务器(advanced_server.py)和FastMCP服务器(main.py)
- Docker支持,易于部署
需求
- Python 3.11+
- openpyxl
- python dotenv
- 媒染剂
- 主控程序
安装依赖项:
pip install -r requirements.txt设置
- 克隆存储库并导航到项目目录。
- 请确保您已安装Python 3.11+。
- (可选)编辑
.env设置EXCEL_FILES_DIR(默认值:./excel_files). - 安装依赖项:
pip install -r requirements.txt运行服务器
在Windows(PowerShell或CMD)上:
run_local.bat在Linux/macOS上:
./run_local.sh这将使用以下命令启动MCP Excel服务器 main.py 并创建 excel_files/ 如果目录不存在。
要运行高级异步服务器,请执行以下操作:
python advanced_server.py用法
- 服务器将Excel文件操作作为MCP资源和工具公开。
- 与任何兼容MCP的客户端集成,或使用CLI进行测试。
- 看
main.py和advanced_server.py所有可用工具及其参数。
Docker使用
使用提供的Dockerfile构建并运行:
docker build -t mcp-excel-server .
docker run -it --rm -v $(pwd)/excel_files:/app/excel_files mcp-excel-server- 默认入口点运行
advanced_server.py. - 使用
main.py,编辑CMD在Dockerfile中。 - Excel文件目录被挂载以实现持久性。
环境变量
EXCEL_FILES_DIR:用于存储Excel文件的目录(默认:./excel_files).
- 产生 .env,或者在运行Docker或脚本时通过环境。
目录详细信息
excel_files/:服务器创建/修改的所有Excel文件都存储在此处。__pycache__/:Python字节码缓存(可以忽略)。
开发说明
- 所有Excel逻辑都在
excel_fucntion.py. - 通过编辑添加新工具/资源
main.py或advanced_server.py. - 对于自定义环境,请更新
.env或者直接传递变量。 - 有关MCP协议的详细信息,请参阅 模型上下文/模型上下文协议.
参考文献
______________________________________________________________________
作者 穆罕默德·阿巴西
许可证: 随心所欲地使用。
