Aruba Central MCP

阿鲁巴中央mcp

英语| 日本语

MCP服务器 阿鲁巴中央 （GreenLake New Central API）。

通过STDIO传输将接入点、交换机和无线客户端状态暴露给MCP兼容的AI助手（Claude Code、Claude Desktop等）。

特性

接入点

客户

基础设施

亮点

• 服务器端OData过滤 用于高效查询
• OAuth2客户端凭据 身份验证（GreenLake SSO）
• 自动分页 对于大型结果集
• 令牌自动刷新 到期前
• 轻量级：仅 mcp SDK+ httpx （无熊猫）

先决条件

• Python 3.10+
• 阿鲁巴中央账户，可访问API（GreenLake New Central API）
• OAuth2客户端凭据（客户端ID和机密）

设置

# uv
uv pip install aruba-central-mcp

# pip
pip install aruba-central-mcp

或者在不安装的情况下运行：

uvx aruba-central-mcp

来源：

git clone https://github.com/shigechika/aruba-central-mcp.git
cd aruba-central-mcp

# uv
uv sync

# pip
pip install -e .

配置

设置以下环境变量：

如何获取API证书

1. 登录 HPE GreenLake平台
2. 首选 管理工作区 > 个人API客户
3. 点击 创建个人API客户端
4. 输入昵称并选择 阿鲁巴中央 作为服务
5. 复制 client_id 和 client_secret — 秘密只显示一次

有关详细信息，请参阅：

• 访问令牌的OAuth API
• 进行API调用

用法

克劳德代码

claude mcp add aruba-central \
  -e ARUBA_CENTRAL_BASE_URL=apigw-uswest4.central.arubanetworks.com \
  -e ARUBA_CENTRAL_CLIENT_ID=your-client-id \
  -e ARUBA_CENTRAL_CLIENT_SECRET=your-client-secret \
  -- uvx aruba-central-mcp

或添加到 .mcp.json:

{
  "mcpServers": {
    "aruba-central": {
      "command": "uvx",
      "args": ["aruba-central-mcp"],
      "env": {
        "ARUBA_CENTRAL_BASE_URL": "apigw-uswest4.central.arubanetworks.com",
        "ARUBA_CENTRAL_CLIENT_ID": "your-client-id",
        "ARUBA_CENTRAL_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

克劳德桌面版

添加 claude_desktop_config.json:

{
  "mcpServers": {
    "aruba-central": {
      "command": "uvx",
      "args": ["aruba-central-mcp"],
      "env": {
        "ARUBA_CENTRAL_BASE_URL": "apigw-uswest4.central.arubanetworks.com",
        "ARUBA_CENTRAL_CLIENT_ID": "your-client-id",
        "ARUBA_CENTRAL_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

直接执行

export ARUBA_CENTRAL_BASE_URL="apigw-uswest4.central.arubanetworks.com"
export ARUBA_CENTRAL_CLIENT_ID="your-client-id"
export ARUBA_CENTRAL_CLIENT_SECRET="your-client-secret"
python3 -m aruba_central_mcp

CLI选项

aruba-central-mcp --version   # Print version and exit
aruba-central-mcp --help      # Show usage and required environment variables
aruba-central-mcp --check     # Verify environment variables and OAuth2 authentication, then exit
aruba-central-mcp             # Start MCP server (STDIO, default)

在没有选项的情况下，该进程作为MCP STDIO服务器运行（MCP客户端使用的模式）。

--check 退出代码： 0 成功， 1 配置错误， 2 身份验证错误。

发展

git clone https://github.com/shigechika/aruba-central-mcp.git
cd aruba-central-mcp

# uv
uv sync --dev
uv run pytest -v

# pip
python3 -m venv .venv
.venv/bin/pip install -e ".[test]"
.venv/bin/pytest -v

API 参考

此服务器使用 绿湖新中环API:

• /network-monitoring/v1/aps --接入点
• /network-monitoring/v1/radios --AP无线电
• /network-monitoring/v1/bssids --BSSID
• /network-monitoring/v1/wlans --WLAN
• /network-monitoring/v1/swarms --AP群/集群
• /network-monitoring/v1/switches --交换机
• /network-monitoring/v1/clients --客户
• /network-monitoring/v1/clients-trend --客户数量趋势
• /network-monitoring/v1/clients-topn-usage --按使用情况排名的顶级客户
• /network-monitoring/v1/top-aps-by-usage --按使用情况列出的顶级AP

许可证

麻省理工学院