阿鲁巴中央mcp
英语| 日本语
MCP服务器 阿鲁巴中央 (GreenLake New Central API)。
通过STDIO传输将接入点、交换机和无线客户端状态暴露给MCP兼容的AI助手(Claude Code、Claude Desktop等)。
特性
接入点
| 工具 | 说明 |
|---|---|
list_aps |
列出所有接入点(带可选站点/状态过滤器) |
list_radios |
列出AP无线电(信道、利用率、本底噪声、TX功率) |
list_bssids |
列出所有BSSID |
list_wlans |
列出WLAN(SSID、安全、VLAN) |
list_swarms |
列出AP集群 |
get_ap_status |
获取特定AP的详细状态 |
get_ap_throughput |
获取AP吞吐量趋势(TX/RX随时间变化) |
get_top_aps |
按带宽使用情况(无线/有线/总)列出的顶级AP |
客户
| 工具 | 说明 |
|---|---|
list_clients |
列出已连接的无线客户端(带可选的SSID/频带过滤器) |
find_client_by_mac |
通过MAC地址查找客户端(直接查找API) |
get_clients_trend |
客户数量随时间的变化趋势 |
get_top_clients_by_usage |
按带宽使用情况排名的顶级客户 |
get_client_mobility_trail |
客户端漫游历史记录 |
基础设施
| 工具 | 说明 |
|---|---|
list_switches |
列出所有开关 |
get_site_summary |
汇总的站点级摘要(AP计数、客户端计数) |
亮点
- 服务器端OData过滤 用于高效查询
- OAuth2客户端凭据 身份验证(GreenLake SSO)
- 自动分页 对于大型结果集
- 令牌自动刷新 到期前
- 轻量级:仅
mcpSDK+httpx(无熊猫)
先决条件
- Python 3.10+
- 阿鲁巴中央账户,可访问API(GreenLake New Central API)
- OAuth2客户端凭据(客户端ID和机密)
设置```bash
uv
uv pip install aruba-central-mcp
pip
pip install aruba-central-mcp
或者在不安装的情况下运行:```bash
uvx aruba-central-mcp
来源:```bash
git clone https://github.com/shigechika/aruba-central-mcp.git
cd aruba-central-mcp
uv
uv sync
pip
pip install -e .
## 配置
设置以下环境变量:
|变量|描述|示例|
|---|---|---|
| `ARUBA_CENTRAL_BASE_URL` |API网关URL| `apigw-uswest4.central.arubanetworks.com` |
| `ARUBA_CENTRAL_CLIENT_ID` |OAuth2客户端ID| `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` |
| `ARUBA_CENTRAL_CLIENT_SECRET` |OAuth2客户端机密| `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |
### 如何获取API证书
1. 登录 HPE GreenLake平台
1. 首选 **管理工作区** > **个人API客户**
1. 点击 **创建个人API客户端**
1. 输入昵称并选择 **阿鲁巴中央** 作为服务
1. 复制 `client_id` 和 `client_secret` — **秘密只显示一次**
有关详细信息,请参阅:
- 访问令牌的OAuth API
- 进行API调用
## 用法
### 克劳德代码```bash
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:```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`:```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"
}
}
}
}
直接执行```bash
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选项```bash
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 身份验证错误。
发展```bash
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
许可证
麻省理工学院
