API-Central — автоматизация Aruba New Central

Инструментарий Python для HPE Aruba Central (New Central) — миграция сетевых устройств, настройка SSID, подготовка коммутаторов и управление платформой GreenLake.

Разработано для работы в качестве MCP-сервера Claude Code, чтобы вы могли управлять сетевыми операциями в диалоговом режиме, а также в качестве автономных инструментов CLI для пакетных процессов миграции.

Функции

88 инструментов MCP в трех доменных серверах (мониторинг, конфигурация, операции)
8-этапный конвейер миграции — обнаружение устройств → проверка конфигурации → перенос в New Central
Создание/удаление SSID с таргетингом по карте областей (на уровне организации, площадки или группы)
Подготовка коммутаторов: VLAN, профили портов, SVI
Управление подписками и устройствами платформы GreenLake (GLP)
Асинхронное устранение неполадок: ping, traceroute, проверка кабеля, сброс PoE, перезагрузка

Предварительные требования

Python ≥ 3.10
uv (рекомендуется) или pip
Учетная запись HPE Aruba Central с учетными данными API (OAuth2 client ID + secret)

Настройка

# 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

Безопасность: config/credentials.yaml и .mcp.json игнорируются git. Никогда не добавляйте их в репозиторий.

Использование

Интеграция с Claude Code MCP

После настройки .mcp.json запустите Claude Code из этой директории — три MCP-сервера (aruba-monitoring, aruba-config, aruba-ops) загрузятся автоматически.

Примеры запросов:

"Перечисли все устройства на площадке Home Lab"
"Создай WPA3 SSID с именем Corp-WiFi в VLAN 100 для всех точек доступа"
"Пропингуй 8.8.8.8 с коммутатора SN123456"

CLI — Конвейер миграции

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

Запускает полную 8-этапную миграцию (обнаружение → назначение → настройка → проверка). Идемпотентно — можно безопасно запускать повторно.

CLI — Конструктор SSID

python run_ssid.py

Интерактивный рабочий процесс создания/удаления SSID.

Структура проекта

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

Запуск тестов

pytest tests/

Все тесты используют фиктивные учетные данные — реальные вызовы API не выполняются.

Документация

См. CLAUDE.md для получения информации о:

Полном справочнике инструментов MCP и соглашениях об именовании глаголов/существительных
Правилах трансляции областей и типов устройств
Шаблонах конечных точек API
Советах по оптимизации стоимости токенов

Безопасность

Учетные данные загружаются во время выполнения из config/credentials.yaml (игнорируется git)
В исходных файлах нет жестко закодированных секретов
Файлы кэша токенов (.token_cache_*.json) игнорируются git
Конфигурация MCP-сервера (.mcp.json) игнорируется git — она содержит локальные пути

Сообщайте о проблемах безопасности через GitHub Issues — не включайте учетные данные в отчеты об ошибках.

API-Central