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にpingを打って"

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-ignored) から読み込まれます

• ソースファイル内にシークレットはハードコードされていません

• トークンキャッシュファイル (.token_cache_*.json) はgit-ignoredです

• MCPサーバー設定 (.mcp.json) はgit-ignoredです（ローカルパスが含まれるため）

セキュリティ上の問題は GitHub Issues から報告してください。バグ報告に認証情報を含めないでください。