hpe-networking-mcp — HPE-Networking-MCP-Toolkit

Der Banner zeigt den aktuellen Backend-Katalog: eine große Tool-Oberfläche bleibt bedarfsgesteuert verfügbar, während der MCP-Client selbst standardmäßig nur drei Router-Tools sieht.

Low-Token-Server für das Model Context Protocol (MCP) für HPE-Networking-Automatisierung: Aruba Central, HPE GreenLake Platform (GLP), ClearPass, Juniper Mist, Ab/Mist, Apstra, Migrationsautomatisierung für ArubaOS 8, EdgeConnect, HPE Aruba UXI und Axis Atmos Cloud.

MCP erlaubt es einem KI-Client — Claude Code, Copilot, Cursor, VS Code oder einem anderen MCP-fähigen Host — auf eine gemeinsame Toolbox zuzugreifen, statt auf ein maßgeschneidertes Plugin pro Anbieter. hpe-networking-mcp ist ein solcher Server: Richten Sie einen beliebigen MCP-Client darauf aus, und er legt einen durchsuchbaren Katalog von HPE-Networking-Operationen hinter einer kleinen, tokenarmen Oberfläche frei.

hpe-networking-mcp bietet MCP-fähigen KI-Clients einen tokenfreundlichen Weg, um Aruba-HPE-Dokumentation zu durchsuchen, genaue OpenAPI-Details nachzuschlagen, die Central Health zu prüfen, Troubleshooting-Workflows auszuführen, die Konfiguration zu erstellen, geschützte ArubaOS-8-Migrationen durchzuführen und geschützte GreenLake-Platform-Operationen zu nutzen. Es ist auf direkten REST-Aufrufen mit httpx aufgebaut.

Die vollständige visuelle Darstellung dieser Informationen – Zielgruppenwahl, Diagramme und den Ablauf der writesafety-ssslusssicherheit – finden Sie auf der GitHub-Pages-Seite von hpe-networking-mcp. Dieses README wird bewusst kurz gehalten; die kanonische Anleitung findet sich unter docs/.

Warum der Router wichtig ist

Richten Sie Ihren MCP-Client auf einen Server aus: src/hpe_networking_mcp/mcp_servers/tool_router.py. Das empfohlene Profil minimal hält die für den Client sichtbare Tool-Liste bei drei Einträgen, während weiterhin der komplette Backend-Katalog verfügbar ist:

1. find_tool – das richtige Backend-Tool finden.

2. invoke_read_tool – nur schreibgeschützte Leseaufrufe ausführen.

3. invoke_tool – ausdrücklich gewollte Schreib-/destructive Aufrufe ausführen.

Related MCP server: Network AI Assistant

Für wen es gedacht ist

Fünf-Minuten-Schnellstart ohne Anmeldedaten

Vergewissern Sie sich, dass die Installation vollständig ist, und starten Sie den MCP-HTTP-Server, bevor Sie Anmeldedaten für Aruba Central oder die GreenLake Platform hinzufügen.

Option A — das veröffentlichte Image pullen (ohne Checkout):

docker run -d --name hpe-networking-mcp \
  -p 127.0.0.1:8010:8010 \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_ALLOWED_HOSTS='127.0.0.1:*,localhost:*' \
  -e MCP_ALLOWED_ORIGINS='http://127.0.0.1:*,http://localhost:*' \
  ghcr.io/secure-ssid/hpe-networking-mcp:latest

Sobald der Startvorgang abgeschlossen ist (sekundenschnell), antwortet curl http://127.0.0.1:8010/livez mit {"status":"ok"}. Die Loopback-beschränkte Veröffentlichung hält den Server von Ihrem LAN fern; die host:*-Zulassungsliste ist immer dann erforderlich, wenn MCP_HOST nicht Loopback. Das Image enthält den OpenAPI-Spec-Index, der bereits beim Build eingebaut ist; zusätzlich ist für das semenable Suchranking ein Rebuild mit Ingestion-Extras erforderlich (--build-arg INSTALL_EXTRAS=ingestion, siehe Produktionsbereitstellung).

Option B — aus dem Quellcode bauen (fügt den Setup-Assistenten, Doctor-Diagnostik und lokale Index-Werkzeuge hinzu):

git clone https://github.com/secure-ssid/hpe-networking-mcp.git
cd hpe-networking-mcp
python3 scripts/setup_wizard.py --yes --skip-credentials
uv run hpe-mcp-doctor
MCP_PORT=8010 bash scripts/run_http_router.sh

Erwartete Ergebnisse:

• Der Assistent gibt jede abgeschlossene Phase aus und endet mit einer „Setup vollständig“-Zusammenfassung. es werden Central-/GLP-Aufrufe gemacht, weder branding tricks: From windows host, et c. mit LF-Zeilenendungen bauen und starten (WSL2 oder entsprechend konfigurierter Checkout) – CRLF-Checkouts bringen die Entry-Skripte im Docker-Build zu Fehlern.

• doctor.py meldet die Prüfungen der lokalen Abhängigkeiten, des Konfigurationspfads und des Index — jedes Ergebnis lautet OK oder nennt Das zu Tun-Behebende, und zwar ohne dass eine Anbieter-API aufgerufen wird.

• Der HTTP-Router gibt eine Zeile Uvicorn running on http://127.0.0.1:8010 aus und läuft dann weiter.

Verbinden Sie einen beliebigen MCP-fähigen Client mit http://127.0.0.1:8010/mcp und versuchen Sie dann einen credentials-freien Discovery-Aufruf:

find_tool("list Aruba Central devices")

Erwartetes Ergebnis: Bewertete Treffer werden direkt aus dem lokalen Tool-Index gelesen, den der Assistent gerade gebaut hat, und sind jeweils mit Herkunfts-Fähigkeit und dem Zustand des Schreib-Gate annotiert. Es wird keine Anbieter-API kontaktiert.

Verbinden in Ihrem Client

Richten Sie einen beliebigen MCP-fähigen Client auf http://127.0.0.1:8010/mcp aus (oder eine stdio-hpe-mcp-router-Konfiguration), und er sieht nur die drei Router-Tools. Copy-Paste-Konfigurationen für Claude, Copilot, VS Code Cursor und andere finden Sie in MCP-Client-Rezepte; die ausgelieferten Beispiele liegen in examples/mcp-clients/.

Die Dokumentsuche ist ein separater, lokaler Build

ask_docs und die restliche RAG-Oberfläche benötigen einen Textkorpus, den diese Projekt bewusst nicht mitliefert. Dieser Korpus besteht ausgescratch-scraped vendor docs, und deren erneute Veröffentlichung ist nicht unsere Aufgabe – siehe ingestion/source_manifest.json, das aussagt, dass man. „Do not commit scraped content“-Inhalte nicht einbauen soll. Bauen Sie ihn selbst, in Eigeverantwortung und unter den Bedingungen jedes Anbieters:

uv run --extra ingestion python ingestion/ingest_docs.py

Planen Sie genug Zeit ein. Der einziehen ist in Stunden zu messen, und die erste RAG-Abfrage lädt zusätzlich das ~250 MB große Einbettungsmodell nomic-embed-text-v1.5 in den Hugging-Face-Cache. Ohne Anmeldedaten ist nicht dasselbe wie offline: Der Quickstart oben benötigt keine Anbieter-Zugänge, aber die Korpus-Erstellung und die erste Abfrage brauchen jeweils Netzzugriff.

Schreibsicherheit auf einen Blick

• find_tool durchsucht nur die lokale Tool-Katalog und ruft nie eine Anbieter-API.

• invoke_read_tool blockt jedes Werkzeug, das nicht als "read-only" annotieren.

• invoke_tool ist bewusst als destruktiv markiert, weil es zusätzlich Schreib-/destruktive Backend-Werkzeuge ausliefern kann – benutzen Sie es nur, wenn ein Schreibzugriff beabsichtigt ist.

• Verwenden Sie zuerst dry_run=True, wenn möglich; die echte Ausführung verlangt dann entweder confirm=True oder eine MCP-Rückfrage, je nach Werkzeug-Schema.

• Schreiben sind auf jeder Plattform Opt-in, einschließlich Central: Unter der Vorgabeeinstellung HPE_MCP_ACCESS_PROFILE=custom bleibt das Schreib-Gate jeder Plattform geschlossen, bis es gesetzt wird. Verwenden Sie safe-read-only, um jede Schreibzugriff unabhängig von den Plattform-Schaltungen abz dejweilen zu blockieren, oder full-read-write, um normale Schreibzugriffe auf allen geladenen Plattformen zu erlauben.

• Voll Lese-/Schreibmodus umgeht nicht die Dry-Run-Phase, Bestätigungen, elicitation oder dezidierten Schutzmechanismen wie das getrennte AOS8-Rollback-Gate.

• Die Anmeldedaten bleiben in config/credentials.yaml oder in Umgebungsvariablen und werden nie committet.

Zerstörende Operationen (reboot_device, disconnect_client) liegen hinter demselben Gate-Flag wie Schreibzugriffe — es gibt keine zusätzliche "betriebliche" Ebene, die dieses Flag umgeht.

Das vollständige Modell für Discovery/Verteilen/Der Schreibsicherheit finden Sie unter Tool-Router.

Projekt-Snapshot

Die vollständigen Zählungen je Backend finden Sie im Tool-Katalog. Alle Neuerungen des letzten getaggten Releases sind in den Versionshinweisen zu 0.9.0 beschrieben, und die Fähigkeitslücken-Matrix ermöglicht reproduzierbare Tool-/Benchmark-Vergleiche.

Aufgabenorientierte Leitfäden

Grundlagen der lokalen Einrichtung

Das Standard-MCP-Clientprofil bleibt bewusst schlank:

HPE_MCP_ROUTER_MODE=minimal
HPE_MCP_TOOLSETS=central,glp,rag

Optionale Produkte nur bei Bedarf aktivieren:

HPE_MCP_ACCESS_PROFILE=custom
HPE_MCP_PRODUCTS=clearpass,mist,apstra,aos8,edgeconnect,uxi,axis,design
HPE_MCP_PRODUCT_ACCESS=read-only

Siehe die optionale Produktmatrix für das vollständige Einrichtungs- und Sicherheitsmodell.

Für eine vertrauenswürdige, vollständig schreibfähige Sitzung verwenden Sie python3 scripts/setup_wizard.py --access-profile full-read-write, damit alle Legacy-Gates ausgerichtet sind, oder die eigenständige examples/mcp-clients/stdio/full-read-write.mcp.json.

.claude/launch.json enthält ein passendes minimales hpe-networking-mcp-Launchprofil für den täglichen Gebrauch. find-Instruments lässt die vollständigen JSON-Schemas standardmäßig aus; fordern Sie include_schema=true nur dann an, wenn ein Client die vollständige Parameterstruktur benötigt.

Erstellen oder aktualisieren Sie den Router-Tool-Index und die API-Spec-Datenbank. Beide werden aus den OpenAPI-Specs abgeleitet, die in diesem Repository eingecheckt sind, sodass sie deterministisch neu erstellt werden und kein Web-Scraping benötigen:

uv run python scripts/ingest_tools.py --products all

Der RAG-Prosatextkorpus wird getrennt davon von ingestion/ingest_docs.py erstellt, wie oben im Schnellstart beschrieben. Er wird nicht als Release-Artefakt ausgeliefert.

Anmeldedaten, Regionenwahl, Env-Variablen für optionale Produkte und den vollständigen Ingestions-/Aktualisierungspfad finden Sie in der Anleitung Erste Schritte.

Streamable-HTTP-Modus

MCP_PORT=8010 bash scripts/run_http_router.sh

Richten Sie dann einen beliebigen MCP-fähigen Client auf http://127.0.0.1:8010/mcp aus. Der Server stellt außerdem /livez, /readyz und /healthz bereit. Bindungen an Nicht-Loopback-Adressen erfordern explicit MCP_ALLOWED_HOSTS/MCP_ALLOWED_ORIGINS und können mit MCP_HTTP_BEARER_TOKEN geschützt werden. Für die stdio- und HTTP-Konfigurationen zum Kopieren und Einfügen siehe MCP-Client-Rezepte.

Projektstruktur

src/hpe_networking_mcp/mcp_servers/     Low-token router + Central/GLP/RAG/optional-product servers
src/hpe_networking_mcp/pipeline/        httpx clients, 8-stage migration pipeline, SSID helpers
ingestion/       Docs/API scraping and LanceDB + SQLite index builders
docs/            Setup, router, architecture, product, and release guides
scripts/         Setup wizard, doctor wrapper, HTTP router helper, release validation
tests/           Unit, integration, and RAG eval coverage
config/          Credentials template; real credentials stay git-ignored
examples/        Tested, non-secret MCP client/prompt/runbook configuration examples
run_pipeline.py  Checkout wrapper for `hpe-mcp-run-pipeline`
run_ssid.py      Checkout wrapper for `hpe-mcp-run-ssid`

Die vollständige Repository-Übersicht, einschließlich generierter/git-ignorierter Pfade, finden Sie in Systemübersicht.

Validierung

uv run pytest tests/unit -q
uv run python scripts/validate_release.py --catalog-products all --strict-tool-index --min-tools 6711

--min-tools 6711 ist die Kompatibilitätsuntergrenze der plattformbezogenen API (die 6.711 plattformbezogenen API-Tools), nicht die Gesamtzahl der registrierten Backend-Tools von 6.728, die auch das rein protokollorientierte Central-Streaming-Tool, den plattformübergreifenden site-health-Aggregator, die lokale GLP-Preflight-Diagnose sowie lokale Tools ohne Zugangsdaten enthalten. Die Validierung ist bei oder oberhalb der Untergrenze erfolgreich. Beide Gesamtzahlen finden sich im Tool-Katalog.

Der Release-Helfer führt Unit-Tests aus, optional RAG/API-Auswertungen, sofern die jeweiligen Indizes existieren, Untergrenzen-Prüfungen für den Tool-Katalog und Frischeprüfungen des lokalen Tool-Indexes. Die Unit-Tests umfassen außerdem statische Guards für den aktiven MCP-/Pipeline-Code, eingecheckte MCP-Konfigurationsbeispiele mit niedrigem Tokens, rein lokale Konfigurationsdateien, Router-Produkt-/Toolset-Dokumentation, begrenzte generische Write-Only-GET-Tools, MCP-Liste mit Standardgrenzen, RAG/Search-top_k-Grenzen, Werkzeuganzahl-Ansprüche, Tool-Anzahl-Docstrings, sowie RAG/Index-Bezeichnungen doc-fact-Kategorie, Markdown-Links und -Bilder lokal in Git getrackt, Pages-Sitemap- und Robots-Metadaten, dokumentierte Router-Beispielargumente, Produkt-Workflow-Toolnamens-Tabellen und die Umgebungstabellen des Setup-Assistenten für optionale Produkte.

Verwandte Projekte und Dank

hpe-networking-mcp ist ein unabhängiges HPE-Networking-MCP-Toolkit, das durch Beobachtung offiziellen MCP-Ökosysteme und Community-Arbeit verbessert wird:

• HewlettPackard/gl-mcp – offizieller GreenLake-Plattform-MCP-Server

• modelcontextprotocol/python-sdk – MCP-Python-SDK

• KarthikSKumar98/central-mcp-server – Community Aruba-Central-MCP-Server

• nowireless4u/hpe-networking-mcp – einheitliche HPE-Networking-MCP-Referenz

Haftungsausschluss

hpe-networking-mcp ist ein unabhängiges Communityprojekt. Es ist kein offizielles HPE?/ oder ein HPE-Aruba-Networking-Produkt und wird weder von HPE empfohlen noch unterstützt.

Lizenz

MIT – siehe repository license. Generierte API-Metadaten möglich und Referenzen zur Upstream-Implementierung sind in THIRD_PARTY_NOTICES.md dokumentiert.