🚀 Proxmox Manager - Proxmox MCP Server

基本能力

产品定位

ProxmoxMCP 是一个专为 Proxmox 虚拟机管理平台设计的 MCP 服务器，旨在通过 Python 提供高效、安全的虚拟机管理接口。

核心功能

• Cline 集成：与 Cline 自主编码代理无缝集成
• MCP SDK 构建：基于官方 MCP SDK 开发
• 安全认证：支持基于令牌的 Proxmox API 认证
• 节点和虚拟机管理：提供多种工具管理节点和虚拟机
• 虚拟机控制台命令执行：支持通过 QEMU Guest Agent 在虚拟机中执行命令
• 日志系统：可配置的日志记录系统
• 类型安全：使用 Pydantic 实现类型安全
• 输出格式化：支持自定义主题的丰富输出格式

适用场景

• 自动化管理 Proxmox 集群
• 批量操作虚拟机
• 监控节点和虚拟机状态
• 远程执行虚拟机命令

工具列表

1. get_nodes：列出集群中的所有节点
2. get_node_status：获取特定节点的详细状态
3. get_vms：列出集群中的所有虚拟机
4. get_storage：列出可用存储
5. get_cluster_status：获取集群整体状态
6. execute_vm_command：在虚拟机控制台中执行命令

常见问题解答

• 认证问题：确保正确配置 API 令牌
• 连接问题：检查 Proxmox 服务器地址和端口
• 命令执行失败：确认虚拟机运行且安装了 QEMU Guest Agent

使用教程

使用依赖

1. 安装 UV 包管理器：pip install uv
2. 确保 Python 3.10 或更高版本
3. 安装 Git
4. 准备 Proxmox 服务器 API 令牌凭证

安装教程

1. 克隆仓库：

git clone https://github.com/canvrno/ProxmoxMCP.git
cd ProxmoxMCP

1. 创建并激活虚拟环境：

uv venv
source .venv/bin/activate  # Linux/macOS
.\\.venv\Scripts\Activate.ps1  # Windows

1. 安装依赖：

uv pip install -e ".[dev]"

1. 创建配置：

mkdir -p proxmox-config
cp config/config.example.json proxmox-config/config.json

调试方式

1. 检查 Python 环境：

python -c "import proxmox_mcp; print('Installation OK')"

1. 运行测试：

pytest

1. 验证配置：

PROXMOX_MCP_CONFIG="proxmox-config/config.json" python -m proxmox_mcp.server

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。