proxmox-mcp

proxmox-mcp ist ein sicherheitsgeschützter, lokaler stdio Model Context Protocol-Server für die Proxmox VE API. Er wird als Prozess von einem MCP-Host gestartet; es handelt sich nicht um einen HTTP-Dienst und er stellt keinen HTTP-Endpunkt bereit.

Status — aktuelle Version: v0.1.1. Die kanonische Distribution ist das GitHub-Release-Archiv und seine SHA-256-Prüfsumme. Es wird kein npm-Paket bereitgestellt oder veröffentlicht.

Installieren des veröffentlichten Proxmox MCP

Für eine lokale stdio-Installation verwenden Sie das prüfsummenverifizierte GitHub-Release-Archiv:

• GitHub Release v0.1.1

• Archiv-Asset

• Prüfsummen-Asset

Es gibt kein npm-Paket. Die LobeHub Marketplace-Listung beschreibt die Fähigkeiten; sie ist nicht die lokale Installationsquelle. ClawHub wird derzeit nicht veröffentlicht, da kein öffentlich installierbarer OpenClaw-Wrapper/Listing verfügbar ist.

Related MCP server: mcp-server-proxmox

Schnellinstallation

Laden Sie das v0.1.1-Archiv und die Prüfsumme von GitHub Releases herunter, verifizieren Sie sie und extrahieren Sie das Archiv. Führen Sie dies auf dem Rechner aus, auf dem der MCP-Host laufen wird.

curl -fLO https://github.com/Theorvane/proxmox-mcp/releases/download/v0.1.1/proxmox-mcp-0.1.1.tar.gz
curl -fLO https://github.com/Theorvane/proxmox-mcp/releases/download/v0.1.1/proxmox-mcp-0.1.1.tar.gz.sha256
shasum -a 256 -c proxmox-mcp-0.1.1.tar.gz.sha256
tar -xzf proxmox-mcp-0.1.1.tar.gz
cd proxmox-mcp-0.1.1

Das Archiv erfordert Node.js >=22. Geben Sie Anmeldeinformationen über die Umgebung an; die untenstehenden Werte sind Platzhalter, keine funktionierenden Anmeldeinformationen.

export PROXMOX_BASE_URL='https://proxmox.example:8006'
export PROXMOX_TOKEN_ID='user@realm!token-name'
: "${PROXMOX_TOKEN_SECRET:?set PROXMOX_TOKEN_SECRET in the environment}"
./proxmox-mcp

./proxmox-mcp ist ein stdio-Prozess. Registrieren oder konfigurieren Sie diesen Befehl, sein Arbeitsverzeichnis und die drei Umgebungsvariablen in Ihrem MCP-Host; das alleinige Starten in einem Terminal macht ihn nicht für einen Client verfügbar. Informationen zum Archivlayout und zur Installation finden Sie im GitHub-Release-Installationsleitfaden.

Konfiguration

Nur diese Umgebungsvariablen werden verwendet:

Die TLS-Zertifikatsprüfung ist immer aktiviert. PROXMOX_TLS_VERIFY=false wird beim Start abgelehnt; verwenden Sie es nicht. Wenn der Proxmox-Endpunkt eine private CA verwendet, vertrauen Sie dieser CA im Host-Vertrauensspeicher. Siehe Konfiguration für die vollständige Richtlinie.

Fähigkeiten

Der Server bietet einen fokussierten Satz von Proxmox VE-Operationen. MCP-Hosts entdecken die genauen Schemata und Tool-Beschreibungen zum Zeitpunkt der Verbindung.

Tool-Namen, Eingaben, Ausgaben und Knotennamen-Validierungsregeln sind im Tool-Vertrag dokumentiert.

Sicherheitsmodell

Löschung, Entfernung ungenutzter Festplatten und erzwungenes Stoppen können nicht rückgängig gemacht werden. Überprüfen Sie die Ziele sorgfältig und geben Sie dem Token nur die benötigten Proxmox-Berechtigungen. Siehe die vollständige Sicherheitsanleitung.

OpenClaw lokale Fähigkeit

Die zusammengeführte dev-Codebasis enthält eine OpenClaw-Fähigkeit unter skills/proxmox-mcp-openclaw/. Es handelt sich um eine lokale Fähigkeit, nicht um ein generisches OpenClaw-Plugin. Verwenden Sie die lokalen SKILL.md-Anweisungen.

Wählen Sie ein neues absolutes Zielverzeichnis—das Ziel darf noch nicht existieren. Überprüfen Sie zuerst den anmeldeinformationsfreien Plan:

node skills/proxmox-mcp-openclaw/scripts/install.mjs --dry-run /absolute/path/to/proxmox-mcp

Mit den drei in der Shell exportierten Konfigurationsvariablen installieren und registrieren Sie es:

node skills/proxmox-mcp-openclaw/scripts/install.mjs /absolute/path/to/proxmox-mcp

Der Installer verifiziert das unveränderliche v0.1.1-Release und seine Prüfsumme und ruft dann den unterstützten Befehl openclaw mcp add nur nach erfolgreichem Preflight auf. Es protokolliert oder speichert keine Anmeldeinformationen.

Betriebsgrenzen

• Dies ist eine lokale stdio-MCP-Integration, kein gehosteter Dienst oder Ersatz für Proxmox-Zugriffskontrollen.

• Der Server stellt keine Proxmox-Anfrage, bis ein MCP-Client ein Tool aufruft. Installations- und Dokumentationsbeispiele rufen keine echte Proxmox-API auf.

• Halten Sie Anmeldeinformationen aus Repositories, der Shell-Historie (wo praktikabel) und gemeinsamen Konfigurationsdateien fern. Verwenden Sie einen Proxmox-API-Token mit minimalen Berechtigungen.

• Beziehen Sie Releases nur von Theorvane/proxmox-mcp GitHub Releases und verifizieren Sie die veröffentlichte SHA-256-Prüfsumme, bevor Sie das Archiv ausführen.

Dokumentation

• Konfiguration

• Sicherheit

• API und Tool-Vertrag

• GitHub-Release-Installation

• Mitwirken

• Sicherheit

Verifizierung und Mitwirken

Mitwirkende arbeiten von einem issue-nummerierten Branch basierend auf dev, öffnen Pull-Requests zu dev und fördern nur überprüftes dev zu main. GitHub-Release-Archive sind der einzige Vertriebskanal. Siehe CONTRIBUTING.md.

Betreuer können die gleichen lokalen Verifizierungsbefehle ausführen, die vom Projekt verwendet werden:

npm ci
npm run lint
npm run typecheck
npm test
npm run build
npm run release:archive
npm run verify:release-archive
npm run validate:docs
npm run validate:governance
npm run validate:release
npm audit --omit=dev --audit-level=high
git diff --check

Lizenz

Dieses Projekt ist unter den Bedingungen in LICENSE lizenziert.