ProxmoxMCP-Plus：为 Proxmox VE 提供 MCP 与 OpenAPI 控制层

项目用途

ProxmoxMCP-Plus 是一个面向 Proxmox VE 的开源控制层。它把 MCP 客户端、AI agent 或普通 HTTP 工具连接到 Proxmox VE，减少运维人员为每项工作分别拼接原始 API、脚本和任务轮询的需要。项目采用 MCP 与 OpenAPI 两条入口：前者面向支持 MCP 的客户端，后者面向 HTTP 自动化、仪表盘、内部工具和无代码流程。

适合谁

它适合已经运行 Proxmox VE、希望把自然语言操作或自动化流程接入虚拟化平台的家庭实验室用户、开发者和平台运维人员。README 列出的客户端包括 Claude Desktop、Cursor、VS Code、Open WebUI 和 Codex。对只需要查看节点、虚拟机、容器或存储状态的用户，工具筛选也有帮助：项目支持 allowlist 或 denylist，且未知工具名会导致启动失败，而不是静默放宽访问范围。

如果团队不希望 AI 直接拥有完整管理能力，项目提供的 API token、命令策略、审批 token、OpenAPI bearer auth，以及 MCP HTTP 的 Host/Origin 控制可以作为部署设计的一部分。不过这些机制是否启用、如何组合，取决于配置；不能把项目本身视为自动完成的安全边界。

已知功能

已公开的功能包括 VM 和 LXC 生命周期操作、创建/回滚/删除快照、备份与恢复、ISO 下载和清理、节点/存储/集群检查，以及带防护的容器命令执行。异步 Proxmox 任务可以通过稳定的 job ID 和 Proxmox UPID 跟踪，并支持轮询、重试、取消和审计历史。项目也支持本地 SQLite 保存任务状态，具体持久化方式需要按环境配置。

v0.6.3 增加了节点时间、节点存储、节点诊断和集群加入信息读取，并加入 LXC 迁移预检与受保护的迁移提交。迁移会返回任务 UPID，并可返回本地 job ID；发布说明要求迁移确认，重启迁移还需要停机确认。项目说明不会自动重试迁移。

采用前的限制

AI 能够触发真实基础设施操作，因此不应只看“能调用工具”就上线。应先创建仅包含所需权限的 Proxmox API token，并分别规划只读、变更和高风险操作。SSH 执行和节点 SSH 命令属于可选能力，启用前应审查命令策略、网络路径和凭据管理。

迁移尤其需要人工流程。v0.6.3 明确表示没有执行真实 Proxmox 迁移；预检不会预留容量，也不会验证备份新鲜度或可恢复性、应用健康状况以及每一项 Proxmox 迁移约束。复杂挂载、未使用卷、自定义设备和 HA 管理的客户机仍需单独处理。提交返回 SUBMISSION_UNCERTAIN 时，应先检查 Proxmox 任务和客户机位置，再考虑再次调用。

部署考虑

项目提供本地 MCP stdio、Docker 中的原生 MCP HTTP，以及 Docker 中的 OpenAPI 路径。远程 HTTP 部署需要认真处理认证、TLS、Host/Origin、外部访问控制和密钥生命周期；README 也说明，允许未认证 HTTP 只代表项目跳过自身密钥检查，并不会替外部访问控制做配置或验证。升级到 v0.6.3 后，需要重启 worker 并重新连接 MCP 客户端以刷新工具发现；现有 SQLite 状态和旧 OAuth 元数据可保留，发布说明称没有数据库迁移。项目仓库声明使用 MIT License，但具体部署仍应由管理员完成权限、备份和变更审批设计。

资料来源

• GitHub repository metadata
• Project README
• Official release
• Official project page

资料核对日期：2026-10-18