AI网络管理服务器

Aruba Central MCP服务器是一个AI驱动的网络管理工具,用于监控、配置和管理Aruba网络设备。

  • by cheenu1092-oss
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 cheenu1092-oss/aruba-central-mcp-server

使用说明

🌐 Aruba中央MCP服务器

HPE Aruba网络中心的MCP(模型上下文协议)服务器——基于AI的网络管理。

通过AI代理管理您的Aruba基础设施(AP、交换机、网关)。

这是什么

MCP服务器,用于包装 阿鲁巴中央休息区API.将您的AI代理(Claude等)连接到:

  • 监视器:设备、客户端、事件、网络健康状况
  • 配置:组、模板、WLAN、设备设置
  • 管理:设备清单、配置、固件
  • 分析:AppRF统计、状态分析、访客访问

两种变体

变体 工作原理 用例
传统 预构建的MCP工具(list_devices, get_client_stats等) 安全、可发现的操作
代码模式 代理获取API架构+执行器,编写原始调用 高级用户、边缘案例、链接

安装

npm install -g aruba-central-mcp-server
# or
npx aruba-central-mcp-server

配置

创建 .env:

# Aruba Central OAuth Credentials (from API Gateway)
ARUBA_CLIENT_ID=your_client_id
ARUBA_CLIENT_SECRET=your_client_secret
ARUBA_CUSTOMER_ID=your_customer_id
ARUBA_USERNAME=your_username
ARUBA_PASSWORD=your_password

# API Base URL (regional)
ARUBA_BASE_URL=https://apigw-prod2.central.arubanetworks.com  # US East
# Or: apigw-uswest4.central.arubanetworks.com (US West)
# Or: apigw-apeast1.central.arubanetworks.com (APAC)
# Or: apigw-eucentral3.central.arubanetworks.com (EU)

# Optional
ARUBA_VERIFY_SSL=true
ARUBA_ENABLE_WRITE=false  # Enable write operations (POST/PUT/DELETE)

获取OAuth凭据

  1. 登录Aruba Central:https://central.arubanetworks.com
  2. 首选 帐户主页 → 平台集成 → API网关
  3. 点击 系统应用程序和令牌 → 添加应用程序和令牌
  4. 创建应用程序,选择API权限,生成令牌
  5. 复制 client_id, client_secret,以及 customer_id

用法

传统模式(预构建工具)

aruba-central-mcp-server traditional
# or
npm start

添加到Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "aruba-central": {
      "command": "npx",
      "args": ["aruba-central-mcp-server", "traditional"],
      "env": {
        "ARUBA_CLIENT_ID": "...",
        "ARUBA_CLIENT_SECRET": "...",
        "ARUBA_CUSTOMER_ID": "..."
      }
    }
  }
}

代码模式(完全API访问)

aruba-central-mcp-server code-mode

API覆盖范围

✅ 监控

  • 设备状态、正常运行时间、连接性
  • 客户端会话、统计数据、连接
  • 网络事件和警报
  • 现场/组监控

✅ 配置

  • 组管理(WLAN、模板、变量)
  • 设备配置(CLI、设置)
  • 模板管理(AP、交换机、网关)
  • WLAN/SSID配置

✅ 设备清单

  • 设备列表、过滤、搜索
  • 配置和入职
  • 固件管理
  • 许可证管理

✅ 来宾访问

  • 游客管理
  • 门户配置
  • 会话跟踪

✅ AppRF(应用程序可见性)

  • 按流量列出的热门应用
  • 每个客户端/设备的应用程序统计信息

📋 未来

  • 状态分析
  • 定位服务
  • 广域网健康监测
  • 安全事件

发展

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Watch mode
npm run test:watch

建筑

src/
├── config.ts                  # OAuth token management
├── client.ts                  # REST client with token refresh
├── traditional/
│   ├── index.ts               # MCP server setup
│   └── tools/
│       ├── monitoring.ts      # Device/client monitoring
│       ├── devices.ts         # Device inventory
│       ├── configuration.ts   # Groups/templates/WLANs
│       ├── apprf.ts           # Application statistics
│       └── guest.ts           # Guest portal
└── code-mode/
    ├── index.ts               # Code mode server
    ├── schemas/               # API schemas
    └── executor.ts            # Sandboxed executor

API 参考

许可证

麻省理工学院

贡献

部分 网络基础设施MCP --网络基础设施MCP服务器的权威集合。