Proxmox Safe MCP

制限付きのインベントリ/ステータス読み取りと、許可リストに登録されたゲストの電源操作とスナップショット作成という2つの狭いミューテーションクラスのみを公開する、焦点を絞ったProxmox MCPサーバーです。spectrenet-mcp のコミット 2e63f009d8f4642e17398685baef0251811d6637 から抽出されたもので、このリポジトリは自己完結型です。

Alpha: テストは合成テストです。Proxmox APIの互換性はすべてのリリースに対して認定されていません。本番以外のインフラストラクチャでテストしてください。

安全契約

• ノードを対象とした操作（node_status）と両方のミューテーションツールでは、ノードが明示的に許可リストに登録されます。ゲストタイプは qemu と lxc のみで、VMIDは正の整数である必要があります。

• cluster_status と list_guests は意図的にクラスタ全体のAPIビューを返し、ノードの許可リストではフィルタリングされません。専用のProxmox APIアカウント/トークンのスコープを設定して、これらの読み取りツールが参照できる範囲を制限してください。

• 電源操作は start、shutdown、reboot、stop のみです。

• スナップショット名は1〜64文字のASCII文字、数字、_、または - です。

• すべてのミューテーションには、バイト単位で一致する APPROVE <action> <target> の確認が必要です。

• ミューテーションの応答は送信の受領証であり、完了の証明ではありません。返されたUPIDと最終状態を別々に確認してください。

• ゲスト/スナップショットの削除、ホストの電源、ストレージの変更、割り当て、移行、構成のツールはありません。node_status は意図的にストレージの列挙を除外しています。

• 応答/リスト/監査フィールドは制限されており、TLS検証はデフォルトで有効です。

Related MCP server: ProxmoxMCP-Plus

インストールと実行

uv sync --extra test
uv run proxmox-safe-mcp --help
uv run proxmox-safe-mcp

サーバーはMCP stdioを使用します。.env は読み込まれません。.env.example はダミーのドキュメントとしてのみ使用し、シークレットはスーパーバイザーまたはシークレットマネージャーを通じて注入してください。

検証

uv sync --locked --extra test
uv run --locked pytest
uv run --locked python -m compileall -q src tests
uv build

アーキテクチャと運用 と セキュリティの詳細 を参照してください。MIT © 2026 Ben Gauger.