RekklesNA/ProxmoxMCP-Plus

解决的问题

ProxmoxMCP-Plus 提供了一个统一且注重安全的控制平面，用于管理 Proxmox VE 环境。它消除了操作员手动组合原始 API 调用、Shell 脚本和自定义轮询来完成常见运维工作流（如 VM 和 LXC 管理、快照和备份）的需要。

工作原理

该项目作为 AI 客户端与 Proxmox VE API 之间的中介层。它通过两个主要访问路径暴露其功能：

• MCP（Model Context Protocol）：使 AI 代理（如 Claude Desktop、Cursor 和 VS Code）能够使用自然语言与 Proxmox 交互。
• OpenAPI：为自动化、仪表板和无代码工具提供标准 HTTP 接口。

它包含一个持久化任务存储（使用 SQLite），通过稳定的 job_id 跟踪长时间运行的异步 Proxmox 任务，允许客户端轮询、重试或取消操作。

适用人群

• AI 代理操作员：希望使用 LLM 驱动的代理控制虚拟化基础设施的用户。
• DevOps/系统管理员：管理 Proxmox VE 的专业人士，需要一个标准化的 OpenAPI 桥接用于自动化。
• 家庭实验室爱好者：希望以简化方式管理虚拟机和容器，并具备集成任务追踪功能的用户。

主要亮点

• 双访问路径：AI 代理专用的原生 MCP 和标准 HTTP 自动化用的 OpenAPI。
• 全面的 VM/LXC 生命周期支持：支持 VM 和 LXC 的创建、启动、停止、删除和快照。
• LXC 命令执行：基于 SSH 的容器命令执行，集成策略控制。
• 任务持久化：通过稳定 job_id 持续追踪异步任务，支持审计历史和重试功能。
• 安全优先设计：支持 Proxmox API 令牌、Bearer 认证、TLS 验证，以及工具白名单/黑名单。