proxmox-mcp-plus Skill 技能

技能简介

ProxmoxMCP-Plus 是一个面向 Proxmox VE 的增强版 MCP 服务器，让 AI 客户端与自动化脚本通过统一控制面操作虚拟机、LXC 容器、快照、备份、ISO 与集群状态。运维人员不必再为每个工作流拼接裸 API 调用、一次性脚本和自定义轮询逻辑。

核心能力

• 双入口设计：原生 MCP 服务供 Claude Desktop、Cursor、VS Code、Open WebUI、Codex 使用，同时暴露 OpenAPI 供 HTTP 自动化、仪表盘与低代码工具调用
• 生命周期管理：虚拟机与 LXC 容器的创建、启动、停止与删除
• 快照与备份：快照创建、回滚、删除，以及备份与恢复流程
• 集群巡检：节点、存储、集群状态查询，ISO 下载与清理
• 受控命令执行：通过 SSH 在容器内执行命令，带命令策略与审批令牌；另有可选开启的节点级 SSH 命令能力
• 长任务作业系统：稳定作业编号、跟踪 Proxmox 的 UPID、轮询、重试、取消与审计历史
• 工具白名单与黑名单：可按需裁剪暴露给模型的工具，拼错工具名会直接导致启动失败，避免误扩大权限

安装配置

• 准备 Proxmox API 令牌，按最小权限原则只授予工作流需要的权限
• 复制示例配置文件，至少填写主机、端口、认证用户名、令牌名与令牌值
• 快速启动：用 uvx 直接运行，或安装后运行 proxmox-mcp-plus
• 远程客户端可走 Docker 的 HTTP 模式，HTTP 自动化可走 OpenAPI 模式

使用步骤

1. 创建并填写配置文件，需要容器命令执行时补上 SSH 段
2. 在 MCP 客户端添加 stdio 服务器，或连接本机八百端口的 MCP 路径
3. 让 Agent 查询节点与虚拟机列表，确认连接正常
4. 执行变更类操作时，按返回的审批令牌流程放行
5. 长任务用作业编号轮询进度，失败可重试或取消

适用场景

• 运维人员用自然语言查询集群健康度与资源占用
• 批量创建或回滚测试环境的快照
• 把备份检查接入内部监控仪表盘
• 给无代码平台提供受控的虚拟机操作接口

适用人群

虚拟化运维工程师、自建机房与家庭实验室用户，以及需要把基础设施操作接进 AI 工作流的平台团队。

工作原理

服务器位于 AI 客户端与 Proxmox VE 之间，把 MCP 与 OpenAPI 两种请求翻译成 Proxmox API 调用；所有变更类操作进入作业队列，用作业编号与 Proxmox UPID 双重跟踪；安全层包含 API 令牌、bearer 鉴权、命令策略、审批令牌与 TLS 校验，并对 MCP 的 HTTP 通道做来源与主机校验。另有可选的代码模式，把工具目录收敛成搜索、取结构、执行三个工具，脚本在隔离沙箱里运行，限制六万四千字符源码、一百兆内存、二十五次工具调用与三十秒预算。

官方链接

• PyPI：https://pypi.org/project/proxmox-mcp-plus/
• GitHub：https://github.com/RekklesNA/ProxmoxMCP-Plus