hpe-networking-mcp — kit de herramientas MCP para HPE Networking

El banner refleja el catálogo backend actual: una amplia superficie de herramientas se mantiene disponible bajo demanda, mientras que el cliente MCP en sí solo ve tres herramientas de router por defecto.

Servidor Model Context Protocol (MCP) de bajo consumo de tokens para la automatización de HPE Networking: Aruba Central, HPE GreenLake Platform (GLP), ClearPass, Juniper Mist, Apstra, automatización de la migración de ArubaOS 8, EdgeConnect, HPE Aruba UXI y Axis Atmos Cloud.

MCP permite que un cliente de IA —Claude Code, Copilot, Cursor, VS Code o cualquier otro host compatible con MCP— acceda a un conjunto de herramientas común en lugar de un plugin específico por proveedor. hpe-networking-mcp es uno de esos servidores: apunta cualquier cliente MCP a él y expone un catálogo buscable de operaciones de redes de HPE detrás de una única superficie, ligera y de bajo consumo de tokens.

hpe-networking-mcp ofrece a los clientes de IA compatibles con MCP una forma de bajo consumo de tokens para buscar documentación de Aruba/HPE, consultar los detalles exactos de OpenAPI, inspeccionar el estado de Central, ejecutar flujos de trabajo de resolución de problemas, gestionar la configuración, llevar a cabo migraciones protegidas de ArubaOS 8 y utilizar operaciones protegidas de GreenLake Platform. Se basa en llamadas REST directas con httpx.

Aquí puede ver el recorrido visual completo de esta misma información —selector de audiencia, diagramas y flujo de seguridad de escritura— en el sitio hpe-networking-mcp GitHub Pages. Este README se mantiene intencionadamente breve; las guías canónicas viven en docs/.

Por qué importa el router

Apunte su cliente MCP a un servidor: src/hpe_networking_mcp/mcp_servers/tool_router.py. El perfil minimal recomendado mantiene la lista de herramientas visibles para el cliente en tres entradas mientras sigue permitiendo acceder al catálogo backend completo:

1. find_tool — descubre la herramienta backend adecuada.

2. invoke_read_tool — ejecuta llamadas de solo lectura.

3. invoke_tool — ejecuta únicamente llamadas de escritura o destructivas intencionadas.

Related MCP server: Network AI Assistant

Para quién es

Inicio rápido sin credenciales en cinco minutos

Verifica la instalación y arranca el servidor HTTP de MCP antes de añadir credenciales de Aruba Central o GreenLake Platform.

Opción A — extraer la imagen publicada (sin descargar el repositorio):

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

Cuando el arranque termine (cuestión de segundos), curl http://127.0.0.1:8010/livez responderá {"status":"ok"}. La publicación de bloqueo por bucle conver. mantiene el servidor fuera de tu LAN; la forma de permitidos con host:* es necesaria siempre que MCP_HOST no sea loopback. La imagen incluye el índice de especificaciones OpenAPI compilado durante el build; la clasificación de búsqueda semántica además necesita un ensamblado adicional de ingesta (--build-arg INSTALL_EXTRAS=ingestion, ver Producción deployment).

Opción B — compilar desde el código fuente (añade el asistente de asistente de configuración, diagnósticos de doctor y herramientas de índice locales):

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

Resultados esperados:

• El asistente imprime cada fase completada y termina con un resumen de configuración completa; no se realizan llamadas a Central/GLP. En hosts Windows, compila y ejecuta desde una shell con finales de línea LF (WSL2 o un checkout configurado): los checkouts con CRLF rompen los scripts de entrada dentro de los builds Docker.

• doctor.py informa de las comprobaciones locales de dependencias, rutas de configuración e índice: todo lee OK o enumera qué corregir, sin llamar a ninguna API del proveedor.

• El router HTTP imprime una línea Uvicorn running on http://127.0.0.1:8010 y sigue ejecutándose en primer plano.

Conecta cualquier cliente compatible con MCP a http://127.0.0.1:8010/mcp y, a continuación, prueba una llamada de descubrimiento sin credenciales:

find_tool("list Aruba Central devices")

Resultado esperado: las coincidencias ordenadas se leen directamente del índice de herramientas local que acaba de construir el asistente; cada una está anotada con su capacidad y estado de compuerta de escritura. No se contacta con ninguna API del proveedor.

Conectarlo en tu cliente

Apunta cualquier cliente compatible con MCP a http://127.0.0.1:8010/mcp (o una configuración stdout de hpe-mcp-router) y verá solo las tres herramientas de enrutador. Configuraciones listas para copiar y pegar para Claude, Pélop, Vesyap, Cursor y otros viven en Recetas de clientes; los ejemplos incluidos están en examples/mcp-clients/.

La búsqueda de documentación es una compilación local aparte

ask_docs y el resto de la superficie de RAG necesitan un corpus de texto que este proyecto deliberadamente no incluye. Ese corpus es documentación extraída de proveedores, y no republicarla es una decisión nuestra; consulta ingestion/source_manifest.json, que siempre ha dicho: "No commit scraped content". Constrúyelo tú mismo, bajo tu propio aceptación de los términos de cada proveedor:

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

Presupuesta también el tiempo. El rastreo se mide en horas, y la primera consulta de RAG descarga además el modelo de incrustACIÓN nomic-embed-text-v1.5 (de ~250 MB) en tu caché de Hugging Face. Sin credenciales no es igual que sin conexión: lo anterior de inicio no requiere credenciales de proveedor, pero la construcción del corpus y la primera consulta en ambos casos necesitan acceso a la red.

Seguridad de escritura de un vistazo

• find_tool solo busca en el catálogo local de herramientas; nunca llama a una API de proveedor.

• invoke_read_tool bloquea cualquier herramienta backend que no esté marcada como solo lectura.

• invoke_tool está deliberadamente marcada como destructive porque también puede ejecutar herramientas backend de escritura/destructivas — úsala solo cuando una escritura sea lo que se busca.

• Usa dry_run=True primero, cuando se soporte; la ejecución real requiere entonces o confirm=True o que MCP lo pida, según el esquema de la herramienta.

• Las escrituras son opt-in en todas las platafoformas, Central incluesta: con el perfil predeterminado HPE_MCP_ACCESS_PROFILE=custom una puerta de escritura de cada herramienta queda cerrada hasta que él la ajustado. Usa safe-read-only para bloquear toda escritura independientemente de las puertas de cada plataforma, o full-read-write para habilitar las escrituras normales en todas las plataformas cargadas.

• El modo lectura/escritura completa no omite el modo dry-run, la confirmación, la intervención del MCP ni otros salvaguardados específicos, como la exclusiva puerta de deshacer de AOS8.

• Las credenciales están en config/credentials.yaml o en variables de entorno, y nunca se confiesen.

| Variable | El valor por defecto | Effect | | ---------------------------- | ---------------------- | history--------------------------------------------------------------------------------------- | | HPE_MCP_ACCESS_PROFILE | custom | safe-read-only deniega todas las escrituras; full-read-write permite todas; custom usa las puertas por plataforma que aparecen abajo | | HPE_MCP_<PLATFORM>_WRITES | 0 | Establece 1 para exponer las herramientas de escritura y destructivas de esa plataforma. |

Las operaciones destructivas (reboot_device, disconnect_client) comparten la misma compuerta que las escrituras; no existe un nivel "operativo" separado que la evite.

Ver Tool router para el modelo completo de discovery / dispatch / write-safety.

Proyecto snapshot

Todas las marcas mencionadas y los componentes: OpenAPI, SNXXX, hpe-router.

Los recuentos completos por backend se encuentran en el Catálogo de herramientas. Consulta las notas de la versión 0.9.0 para conocer todo lo añadido en la última versión etiquetada y la matriz de brechas de capacidad para ver comparaciones reproducibles de herramientas/benchmarks.

Guías orientadas a tareas

Conceptos esenciales de la configuración local

El perfil de cliente MCP predeterminado se mantiene ligero:

HPE_MCP_ROUTER_MODE=minimal
HPE_MCP_TOOLSETS=central,glp,rag

Activa los productos opcionales solo cuando sean necesarios:

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

Consulta la matriz de productos opcionales para conocer el modelo completo de configuración y seguridad.

Para una sesión de confianza y con plena capacidad de escritura, usa python3 scripts/setup_wizard.py --access-profile full-read-write para que todos los controles heredados queden alineados, o usa el archivo autónomo examples/mcp-clients/stdio/full-read-write.mcp.json.

.claude/launch.json incluye un perfil de inicio mínimo correspondiente para hpe-networking-mcp para el uso diario. find_tool omite los esquemas JSON completos de forma predeterminada; solicita include_schema=true solo cuando un cliente necesite obtener la forma completa de los parámetros.

Compila o actualiza el índice de herramientas del enrutador y la base de datos de especificaciones de API. Ambos se derivan de las especificaciones OpenAPI incluidas en este repositorio, por lo que se reconstruyen de forma determinista y no necesitan scraping:

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

El corpus de prosa de RAG se construye por separado con ingestion/ingest_docs.py, como se describe en la guía de inicio anterior. No se distribuye como un recurso de la versión.

Consulta Primeros pasos para las credenciales, la selección de la región, las variables de entorno de productos opcionales y la ruta completa de ingesta/refresco.

Modo HTTP streamable

MCP_PORT=8010 bash scripts/run_http_router.sh

A continuación, apunta cualquier cliente compatible con MCP a http://127.0.0.1:8010/mcp. El servidor también ofrece los endpoints /livez, /readyz y /healthz. Las interfaces no loopback obligan a especificar MCP_ALLOWED_HOSTS/MCP_ALLOWED_ORIGINS y pueden protegerse con MCP_HTTP_BEARER_TOKEN. Consulta las Recetas de cliente MCP para ver configuraciones de stdio y HTTP listas para copiar y pegar.

Estructura del proyecto

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`

El mapa completo del repositorio, incluidas las rutas generadas o ignoradas por git, se encuentra en Descripción general del sistema.

Validación

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 es el límite mínimo de compatibilidad de la API de la plataforma (las herramientas de la API de plataforma expuestas al proveedor, 6.711), no el total completo de backend registrados de 6.728, que también incluye la herramienta de Central Streaming solo de protocolo, el agregador de plataforma cruzada site-health, el diagnóstico local GLP preflight y las herramientas locales sin credenciales; la validación se supera al alcanzar el límite o superarlo. Consulta el Catálogo de herramientas para conocer ambos totales.

El asistente de versión ejecuta las pruebas unitarias, la evaluación opcional de RAG/API cuando existen índices, las verificación de límites del catálogo de herramientas y las comprobaciones de actualización del índice de herramientas local. Las pruebas unitarias también incluyen protecciones estáticas para el código activo de MCP/pipeline, los ejemplos de configuración de MCP de bajo token incorporados, los archivos de configuración de solo local, las rutas de la documentación del router y del conjunto de herramientas, las herramientas GET genéricas de solo lectura acotadas, los límites de lista de MCP por defecto, los límites de top_k de la búsqueda RAG y de la búsqueda general, las afirmaciones públicas sobre el número de herramientas, los docstrings que comunican el número de herramientas, las comprobaciones de hechos documentales del renderizado de RAG/índice, los enlaces e imágenes de Markdown locales rastreados, el sitemap y metadatos de robots de Pages, los argumentos de ejemplo documentados para el router, las tablas de nombres de herramientas de trabajo de flujo de productos y las tablas de variables de entorno de productos opcionales del asistente.

Proyectos relacionados y agradecimientos

hpe-networking-mcp es un kit de herramientas MCP independiente de HPE Networking, derivado delos proyectos oficiales del ecosistema MCP y del trabajo de la comunidad:

• HewlettPackard/gl-mcp - servidor MCP oficial de la plataforma GreenLake

• modelcontextprotocol/python-sdk - SDK de Python para MCP

• karthikskumar98/central-mcp-server - servidor de la comunidad para Aruba Central MCP

• nowireless4u/hpe-networking-mcp - referencia unificada de MCP para redes HPE

Aviso legal

hpe-networking-mcp es un proyecto comunitario independiente. No es un producto oficial de HPE o HPE Aruba Networking y no cuenta con el respaldo ni la asistencia de HPE.

Licencia

MIT - consulta la licencia del repositorio. La metadata de API generada y las referencias de implementación ascendentes están documentadas en THIRD_PARTY_NOTICES.md.