RekklesNA/ProxmoxMCP-Plus

何を解決するか

ProxmoxMCP-Plus は、Proxmox VE 環境を統合的かつセキュリティを意識した制御プレーンとして提供します。VM および LXC の管理、スナップショット、バックアップなどの一般的な運用ワークフローにおいて、手動で API 呼び出し、シェルスクリプト、カスタムポーリングを組み合わせる必要をなくします。

動作方法

このプロジェクトは、AI クライアントと Proxmox VE API の間の仲介層として機能します。主に以下の2つのアクセス経路を通じて機能を公開しています：

• MCP（Model Context Protocol）：Claude Desktop、Cursor、VS Code などの AI エージェントが自然言語を使って Proxmox と対話できるようにします。
• OpenAPI：自動化、ダッシュボード、ノーコードツール向けの標準 HTTP インターフェースを提供します。

SQLite を使用した永続的なジョブストアを備えており、安定した job_id を使って非同期の Proxmox タスクを追跡できます。クライアントはポーリング、再試行、または操作のキャンセルが可能です。

対象ユーザー

• AI エージェント運用者：LLM ベースのエージェントを使って仮想化インフラを制御したいユーザー。
• DevOps / システム管理者：Proxmox VE を管理するプロフェッショナルで、自動化用の標準 OpenAPI ブリッジが必要な人。
• ホームラボ愛好家：VM とコンテナを統合されたジョブ追跡機能で簡素化して管理したいユーザー。

特徴

• 二重アクセス経路：AI エージェント向けのネイティブ MCP と、標準 HTTP 自動化向けの OpenAPI。
• 包括的な VM/LXC ライフサイクル：VM および LXC の作成、起動、停止、削除、スナップショットのサポート。
• LXC コマンド実行：SSH をバックエンドに持つコンテナ向けコマンド実行と、統合されたポリシー制御。
• ジョブの永続化：安定した非同期タスク追跡、監査履歴、再試行機能を備える。
• セキュリティ最優先設計：Proxmox API トークン、Bearer 認証、TLS 検証、ツールの許可リスト/拒否リストをサポート。