openstack-mcp

Ein MCP-Server, der es einem KI-Assistenten ermöglicht, eine OpenStack-Cloud zu inspizieren und zu bedienen – Instanzen auflisten, Quotas prüfen, das Konsolenprotokoll einer festhängenden VM lesen und (wenn Sie es erlauben) Server erstellen und löschen.

Funktioniert mit jeder OpenStack-Umgebung: CloudPe, OVHcloud, Infomaniak, Universitäts- und Forschungs-Clouds oder einem lokalen DevStack. Alles, was openstacksdk erreichen kann, lässt sich damit steuern.

Standardmäßig nur lesend. Schreibzugriff erfordert eine ausdrückliche Freigabe, Löschzugriff eine zweite. Ein Assistent, der Ihr Projekt auflisten kann, kann es nicht abreißen, sofern Sie nicht entschieden haben, dass er das darf.

Schnellstart

Aus dem Quellcode installieren (noch nicht auf PyPI):

pipx install git+https://github.com/abhishekambad-leapswitch/openstack-mcp

Richten Sie ihn auf eine Cloud aus. openstacksdk liest die Standard-OpenStack-Konfiguration, also entweder eine clouds.yaml:

# ~/.config/openstack/clouds.yaml
clouds:
  cloudpe:
    auth_type: v3applicationcredential
    auth:
      auth_url: https://<your-region>.cloudpe.com:5000/v3
      application_credential_id: <id>
      application_credential_secret: <secret>
    region_name: RegionOne

...oder die üblichen Umgebungsvariablen (OS_AUTH_URL, OS_APPLICATION_CREDENTIAL_ID, OS_APPLICATION_CREDENTIAL_SECRET). Dieser Server speichert oder überträgt Ihre Anmeldedaten niemals selbst – er übergibt sie an openstacksdk, das sie auf dieselbe Weise auflöst wie das openstack-CLI.

Claude Code

claude mcp add openstack --env OS_CLOUD=cloudpe -- openstack-mcp

Claude Desktop / Cursor / jeder MCP-Client

{
  "mcpServers": {
    "openstack": {
      "command": "openstack-mcp",
      "env": { "OS_CLOUD": "cloudpe" }
    }
  }
}

Fragen Sie dann Dinge wie „Welche VMs sind down?“, „Habe ich für drei weitere m1.large noch Budget?“ oder „web-03 akzeptiert kein SSH- Schlüssel – prüfen Sie das Konsolenprotokoll.“

Um zu bestätigen, was Sie verdrahtet haben, bevor Sie es vertrauen, führen Sie eine Trockenrennung aus – sie gibt die aufgelöste Konfiguration und genau die Tools aus, die exponiert sind, ohne mit Verbindung zu bedienen oder einen Verbindung:

openstack-mcp --check

openstack-mcp 0.1.0
cloud: cloudpe
mode: read-only
max items per list: 50
12 tools: check_capacity, cloud_info, get_console_output, get_quotas, get_server,
list_flavors, list_images, list_keypairs, list_networks, list_security_groups,
list_servers, list_volumes

Das Sicherheitsmodell

Die meisten Cloud-MCP-Server übergeben einem Assistenten die gesamte API und hoffen auf den Best. Dieser funktioniert mit Zugriffssperren, denn „Lösche die Test-VMs“ ist ein Satz, den ein Modell missverstehen kann.

Zwei weitere Schutzmechanismen:

• delete_server verlangt eine Bestätigung. Sie müssen confirm_name mit dem exakten Namen der aufgelösten Instanz angeben. Wenn Sie ihn bitten, web-1 zu löschen, während die VM web-01 heißt, verweigert die VM die Löschung, statt zu raten.

• Die Tools tragen MCP-Annotationen (read_only_hint, destructive_hint), sodass Clients, die das Risiko vor dem Ausführen eines Tools sichtbar machen, das korrekt tun können.

Diese Tool-Freigabe wird bei der Registrierung erzwungen, nicht durch freundliches Bitten des Modells – in der Testsuite wird das über eine reale stdio-Sitzung nachgewiesen.

Tools

Lesen (immer verfügbar)

Schreiben (opt-in)

Zwei Design-Entscheidungen, die Sie kennen sollten

Antworten sind bewusst schlank. openstacksdk liefert über 60 Zeilen pro Server. Alles User finden anrichten zu füttern ist langsam und teuer und begraben die nützlichen Felder. Deshalb geben alle Tools eine bereinigte Sicht zurück – einblock. Bei einem Server bleiben id, name, Status und eine flache {network: [ips]}-Map, statt der verschachtelten Adressstruktur von nova.

check_capacity gibt es, damit Batchäufe früh fehlschlagen. Wenn man acht VMs erwartet und noch der fünften die Quota-Grenze entdeckt, entsteht ein halbfertiges Durcheinander. Dieses Werkzeug berichtet, ob zuerst Instances, vCPUs oder RAM blocken, bevor etwas tatsächlich erstellt wird. create_servers meldet darüber hinaus Teilfehlschläge pro Instanz, statt das Errungene zu verwerfen.

Entwicklung

git clone https://github.com/abhishekambad-leapswitch/openstack-mcp
cd openstack-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest && ruff check .

Die Testsuite läuft vollständig offline gegen eine openstacksdk-Verbindung ohne echte Cloud – keine Cloud, keine Zugangsdaten, keine Kosten. Sie deckt die Tool-Gateing, das Kürzen, die Quoten-Arithmetik, die Berichte von Teilfehlern und die Löschbestätigung ab.

Größenordnung

Für das deklarative Aufsetzen größerer Gruppen siehe cloudpe-terraform-bulk-vm – Terraform für die Massenerstellung von VMs auf demselben API.

Lizenz

MIT