API-Central — Aruba New Central 자동화

HPE Aruba Central(New Central)을 위한 Python 도구 — 네트워크 장치 마이그레이션, SSID 구성, 스위치 프로비저닝 및 GreenLake 플랫폼 관리.

Claude Code MCP 서버로 작동하여 대화형으로 네트워크 운영을 수행할 수 있으며, 배치 마이그레이션 워크플로우를 위한 독립형 CLI 도구로도 사용할 수 있습니다.

주요 기능

• 3개 도메인 서버(모니터링, 구성, 운영)에 걸친 88개의 MCP 도구

• 8단계 마이그레이션 파이프라인 — 장치 검색 → 구성 확인 → New Central로 푸시

• 범위 맵 타겟팅(조직 전체, 사이트 또는 그룹)을 통한 SSID 생성/삭제

• 스위치 프로비저닝: VLAN, 포트 프로필, SVI

• GreenLake 플랫폼(GLP) 구독 및 장치 관리

• 비동기 문제 해결: ping, traceroute, 케이블 테스트, PoE 바운스, 재부팅

사전 요구 사항

• Python ≥ 3.10

• uv (권장) 또는 pip

• API 자격 증명(OAuth2 클라이언트 ID + 비밀번호)이 있는 HPE Aruba Central 계정

설정

# 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-ignored 처리되어 있습니다. 절대 커밋하지 마십시오.

사용법

Claude Code MCP 통합

.mcp.json이 구성되면 이 디렉토리에서 Claude Code를 시작하십시오. 3개의 MCP 서버(aruba-monitoring, aruba-config, aruba-ops)가 자동으로 로드됩니다.

프롬프트 예시:

• "Home Lab 사이트의 모든 장치 나열해줘"

• "모든 AP에 대해 VLAN 100에서 Corp-WiFi라는 WPA3 SSID를 생성해줘"

• "스위치 SN123456에서 8.8.8.8로 핑을 보내줘"

CLI — 마이그레이션 파이프라인

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

전체 8단계 마이그레이션(검색 → 할당 → 구성 → 확인)을 실행합니다. 멱등성(Idempotent)을 보장하므로 다시 실행해도 안전합니다.

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-ignored)에서 로드됩니다.

• 소스 파일에 하드코딩된 비밀 정보는 없습니다.

• 토큰 캐시 파일(.token_cache_*.json)은 git-ignored 처리됩니다.

• MCP 서버 구성(.mcp.json)은 로컬 경로를 포함하므로 git-ignored 처리됩니다.

보안 문제는 GitHub Issues를 통해 보고해 주십시오. 버그 보고서에 자격 증명을 포함하지 마십시오.