Proxmox Safe MCP

Ein fokussierter Proxmox MCP-Server, der begrenzte Inventar-/Statusabfragen und nur zwei schmale Mutationsklassen bereitstellt: auf der Whitelist stehende Gast-Power-Aktionen und Snapshot-Erstellung. Extrahiert aus dem spectrenet-mcp-Commit 2e63f009d8f4642e17398685baef0251811d6637; dieses Repository ist eigenständig.

Alpha: Tests sind synthetisch. Die Proxmox-API-Kompatibilität wurde nicht für jede Version zertifiziert; testen Sie auf Nicht-Produktions-Infrastruktur.

Sicherheitsvertrag

• Knoten sind für knotenbezogene Operationen (node_status) und beide Mutationswerkzeuge explizit auf die Whitelist gesetzt; Gasttypen sind nur qemu und lxc; VMIDs müssen positive ganze Zahlen sein.

• cluster_status und list_guests geben absichtlich clusterweite API-Ansichten zurück und werden nicht durch die Knoten-Whitelist gefiltert. Beschränken Sie das dedizierte Proxmox-API-Konto/Token, um zu begrenzen, was diese Lesewerkzeuge sehen können.

• Power-Aktionen sind nur start, shutdown, reboot und stop.

• Snapshot-Namen bestehen aus 1–64 ASCII-Buchstaben, Ziffern, _ oder -.

• Jede Mutation erfordert eine bytegenaue Bestätigung APPROVE <action> <target>.

• Mutationsantworten sind Einreichungsbelege, kein Nachweis der Fertigstellung. Überprüfen Sie die zurückgegebene UPID und den endgültigen Zustand separat.

• Es gibt keine Werkzeuge zum Löschen von Gästen/Snapshots, Host-Power, Speichermutation, Zuweisung, Migration oder Konfiguration. node_status schließt die Speicheraufzählung bewusst aus.

• Antworten/Listen/Audit-Felder sind begrenzt und die TLS-Verifizierung ist standardmäßig aktiviert.

Related MCP server: ProxmoxMCP-Plus

Installation und Ausführung

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

Der Server verwendet MCP stdio. Er lädt keine .env; verwenden Sie .env.example nur als Scheindokumentation und injizieren Sie Geheimnisse über einen Supervisor oder Secret Manager.

Verifizieren

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

Siehe Architektur und Betrieb und Sicherheitsdetails. MIT © 2026 Ben Gauger.