API-Central — Automatización de Aruba New Central

Herramientas de Python para HPE Aruba Central (New Central): migración de dispositivos de red, configuración de SSID, aprovisionamiento de switches y gestión de la plataforma GreenLake.

Diseñado para funcionar como un servidor MCP de Claude Code para que pueda gestionar las operaciones de red de forma conversacional, y como herramientas CLI independientes para flujos de trabajo de migración por lotes.

Características

• 88 herramientas MCP a través de tres servidores de dominio (monitorización, configuración, operaciones)

• Canalización de migración de 8 etapas: descubrir dispositivos → verificar configuración → enviar a New Central

• Creación/eliminación de SSID con segmentación por alcance (a nivel de organización, sitio o grupo)

• Aprovisionamiento de switches: VLAN, perfiles de puerto, SVI

• Gestión de suscripciones y dispositivos de la plataforma GreenLake (GLP)

• Solución de problemas asíncrona: ping, traceroute, prueba de cable, reinicio de PoE, reinicio de dispositivo

Requisitos previos

• Python ≥ 3.10

• uv (recomendado) o pip

• Cuenta de HPE Aruba Central con credenciales de API (ID de cliente OAuth2 + secreto)

Configuración

# 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

Seguridad: config/credentials.yaml y .mcp.json están ignorados por git. Nunca los incluya en el repositorio.

Uso

Integración con Claude Code MCP

Una vez configurado .mcp.json, inicie Claude Code desde este directorio: los tres servidores MCP (aruba-monitoring, aruba-config, aruba-ops) se cargarán automáticamente.

Ejemplos de prompts:

• "Lista todos los dispositivos en el sitio Home Lab"

• "Crea un SSID WPA3 llamado Corp-WiFi en la VLAN 100 para todos los AP"

• "Haz ping a 8.8.8.8 desde el switch SN123456"

CLI — Canalización de migración

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

Ejecuta la migración completa de 8 etapas (descubrir → asignar → configurar → verificar). Idempotente: seguro para volver a ejecutar.

CLI — Generador de SSID

python run_ssid.py

Flujo de trabajo interactivo para crear/eliminar SSID.

Estructura del proyecto

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

Ejecución de pruebas

pytest tests/

Todas las pruebas utilizan credenciales simuladas: no se realizan llamadas reales a la API.

Documentación

Consulte CLAUDE.md para:

• Referencia completa de herramientas MCP y convenciones de nomenclatura de verbos/sustantivos

• Reglas de traducción de alcance y tipo de dispositivo

• Patrones de endpoints de API

• Consejos de optimización de costes de tokens

Seguridad

• Las credenciales se cargan en tiempo de ejecución desde config/credentials.yaml (ignorado por git)

• No hay secretos codificados en los archivos fuente

• Los archivos de caché de tokens (.token_cache_*.json) están ignorados por git

• La configuración del servidor MCP (.mcp.json) está ignorada por git: contiene rutas locales

Informe de problemas de seguridad a través de GitHub Issues: no incluya credenciales en los informes de errores.