API-Central — Aruba New Central 自动化

用于 HPE Aruba Central (New Central) 的 Python 工具集 — 支持网络设备迁移、SSID 配置、交换机配置以及 GreenLake 平台管理。

设计为 Claude Code MCP 服务器，以便您通过对话驱动网络运维，同时也可用作批量迁移工作流的独立 CLI 工具。

功能特性

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 忽略。切勿提交它们。

使用方法

Claude Code MCP 集成

配置好 .mcp.json 后，从该目录启动 Claude Code — 三个 MCP 服务器（aruba-monitoring、aruba-config、aruba-ops）将自动加载。

示例提示词：

“列出 Home Lab 站点的所有设备”
“为所有 AP 在 VLAN 100 上构建一个名为 Corp-WiFi 的 WPA3 SSID”
“从交换机 SN123456 ping 8.8.8.8”

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 端点模式
Token 成本优化建议

安全性

凭据在运行时从 config/credentials.yaml（已 git 忽略）加载
源代码中未硬编码任何密钥
Token 缓存文件 (.token_cache_*.json) 已被 git 忽略
MCP 服务器配置 (.mcp.json) 已被 git 忽略 — 它包含本地路径

请通过 GitHub Issues 报告安全问题 — 请勿在错误报告中包含凭据。

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

API-Central