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 驗證，以及工具白名單/黑名單。