API-Central — Aruba New Central-Automatisierung

Python-Tools für HPE Aruba Central (New Central) — Netzwerkgerätemigration, SSID-Konfiguration, Switch-Bereitstellung und GreenLake-Plattform-Verwaltung.

Entwickelt für die Verwendung als Claude Code MCP-Server, damit Sie Netzwerkoperationen konversationell steuern können, sowie als eigenständige CLI-Tools für Batch-Migrations-Workflows.

Funktionen

• 88 MCP-Tools über drei Domänenserver (Überwachung, Konfiguration, Betrieb)

• 8-stufige Migrations-Pipeline — Geräte entdecken → Konfiguration verifizieren → an New Central übertragen

• SSID-Erstellung/-Löschung mit Scope-Map-Targeting (organisationsweit, Standort oder Gruppe)

• Switch-Bereitstellung: VLANs, Port-Profile, SVIs

• GreenLake-Plattform (GLP) Abonnement- und Geräteverwaltung

• Asynchrone Fehlerbehebung: Ping, Traceroute, Kabeltest, PoE-Bounce, Neustart

Voraussetzungen

• Python ≥ 3.10

• uv (empfohlen) oder pip

• HPE Aruba Central-Konto mit API-Zugangsdaten (OAuth2 Client ID + Secret)

Einrichtung

# 1. Clone and install dependencies
git clone https://github.com/your-org/API-Central.git
cd API-Central
uv sync

# 2. Configure credentials
cp config/credentials.yaml.example config/credentials.yaml
# Edit config/credentials.yaml — fill in client_id, client_secret, base_url

# 3. Configure MCP servers (for Claude Code integration)
cp .mcp.json.example .mcp.json
# Edit .mcp.json — replace /path/to/API-Central with your actual clone path

Sicherheit: config/credentials.yaml und .mcp.json werden von git ignoriert. Committen Sie diese niemals.

Verwendung

Claude Code MCP-Integration

Sobald .mcp.json konfiguriert ist, starten Sie Claude Code aus diesem Verzeichnis — die drei MCP-Server (aruba-monitoring, aruba-config, aruba-ops) werden automatisch geladen.

Beispiel-Prompts:

• "List all devices at the Home Lab site"

• "Build a WPA3 SSID called Corp-WiFi on VLAN 100 for all APs"

• "Ping 8.8.8.8 from switch SN123456"

CLI — Migrations-Pipeline

python run_pipeline.py --input inputs/devices.csv

Führt die vollständige 8-stufige Migration aus (entdecken → zuweisen → konfigurieren → verifizieren). Idempotent — sicher bei erneutem Ausführen.

CLI — SSID-Builder

python run_ssid.py

Interaktiver Workflow zum Erstellen/Löschen von SSIDs.

Projektstruktur

mcp_servers/
  monitoring.py       Monitoring tools (health, trends, wireless metrics)
  config.py           Config tools (SSIDs, VLANs, profiles, webhooks, firmware)
  ops.py              Ops tools (reboots, ping, cable test, PoE bounce, GLP)
  shared.py           Shared utilities
pipeline/
  clients/            CentralClient, GLPClient, MCPClient, TokenManager
  stages/             s1_discover → s8_verify
  config.py           Credential loader
  ssid_underlay.py    SSID build/delete logic
config/
  credentials.yaml.example   Template — copy to credentials.yaml and fill in
resources/            Postman download script (collections git-ignored — see resources/README.md)
inputs/               CSV templates for batch migration
tests/                Unit + integration tests

Tests ausführen

pytest tests/

Alle Tests verwenden Mock-Zugangsdaten — keine echten API-Aufrufe.

Dokumentation

Siehe CLAUDE.md für:

• Vollständige Referenz der MCP-Tools und Namenskonventionen für Verben/Substantive

• Übersetzungsregeln für Scopes und Gerätetypen

• API-Endpunkt-Muster

• Tipps zur Optimierung der Token-Kosten

Sicherheit

• Zugangsdaten werden zur Laufzeit aus config/credentials.yaml geladen (von git ignoriert)

• Keine Secrets sind in Quelldateien hartcodiert

• Token-Cache-Dateien (.token_cache_*.json) werden von git ignoriert

• Die MCP-Server-Konfiguration (.mcp.json) wird von git ignoriert — sie enthält lokale Pfade

Melden Sie Sicherheitsprobleme über GitHub Issues — fügen Sie keine Zugangsdaten in Fehlerberichte ein.