内容
<!-- mcp-name: io.github.zw008/vmware-aria -->
# VMware Aria Operations MCP 技能
> **注意**: 在 VCF 9.0 及后续版本中，**VMware Aria Operations** 已更名为 **VCF Operations**。此技能适用于这两个名称 — `/suite-api/` REST 端点保持不变。
> **作者**: Wei Zhou, VMware by Broadcom — wei-wz.zhou@broadcom.com
> 这是一个由 VMware 工程师发起的社区驱动项目，而不是官方 VMware 产品。
> 有关官方 VMware 开发工具，请参阅 [developer.broadcom.com](https://developer.broadcom.com)。
通过模型上下文协议（MCP）为 VMware Aria Operations（vRealize Operations）提供 AI 辅助监控和容量规划。
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
## 概述
`vmware-aria` 暴露了 27 个 MCP 工具，用于通过自然语言 AI 代理（Claude Code、Cursor、Goose 等）与 Aria Operations 交互：
| 类别 | 工具 | 类型 |
|----------|-------|------|
| **资源** | list, get, metrics, health badge, top consumers | 只读 (5) |
| **警报** | list, get, acknowledge, cancel, definitions | 读取 + 2 写 (5) |
| **警报定义** | symptom definitions, create, enable/disable, delete | 读取 + 3 写 (4) |
| **容量** | overview, remaining, time-remaining, rightsizing | 只读 (4) |
| **报告** | definitions, generate, list, get, delete | 读取 + 2 写 (5) |
| **异常** | list anomalies, risk badge | 只读 (2) |
| **健康** | platform health, collector groups | 只读 (2) |
**总数**：27 个工具 — 20 个只读，7 个写
## 快速入门
```bash
# 安装
uv tool install vmware-aria
# 配置
mkdir -p ~/.vmware-aria
cat > ~/.vmware-aria/config.yaml << 'EOF'
targets:
prod:
host: aria-ops.example.com
username: admin
port: 443
verify_ssl: true
auth_source: LOCAL
default_target: prod
EOF
# 设置密码（从不放在 config.yaml 中）
echo "VMWARE_ARIA_PROD_PASSWORD=your_password" > ~/.vmware-aria/.env
chmod 600 ~/.vmware-aria/.env
# 验证设置
vmware-aria doctor
```
## CLI 示例
```bash
# 列出 CPU 占用率最高的 10 个对象
vmware-aria resource top --metric cpu|usage_average --top 10
# 检查活动 CRITICAL 警报
vmware-aria alert list --criticality CRITICAL
# 确认警报
vmware-aria alert acknowledge <alert-id>
# 获取 VM 的 4 小时 CPU + 内存指标
vmware-aria resource metrics <vm-id> --metrics cpu|usage_average,mem|usage_average --hours 4
# 检查集群容量
vmware-aria capacity remaining <cluster-id>
vmware-aria capacity time-remaining <cluster-id>
# 查找权利调整机会
vmware-aria capacity rightsizing
# 检查 Aria 平台健康状况
vmware-aria health status
vmware-aria health collectors
```
## MCP 设置（Claude Code）
安装 `uv tool install vmware-aria` 后，添加到 `~/.claude.json`：
```json
{
"mcpServers": {
"vmware-aria": {
"command": "vmware-aria",
"args": ["mcp"],
"env": {
"VMWARE_ARIA_CONFIG": "~/.vmware-aria/config.yaml"
}
}
}
}
```
> **v1.5.15+** 使用单命令形式 `vmware-aria mcp`。旧版 `vmware-aria-mcp` 控制台脚本仍保留以实现向后兼容。
> 如果必须使用 `uvx --from vmware-aria vmware-aria mcp`（无需安装）并在企业 TLS 代理后面遇到 `invalid peer certificate: UnknownIssuer` 错误，请设置 `UV_NATIVE_TLS=true` 或使用上述推荐的 `vmware-aria mcp` 形式。
然后使用自然语言：
- *"显示当前 CPU 占用率最高的 10 个对象"*
- *"列出所有 CRITICAL 警报并确认它们"*
- *"生产集群的内存还剩多少时间？"*
- *"哪些 VM 被过度配置？显示权利调整建议"*
- *"vm-web-01 上有任何异常吗？"*
## 身份验证
Aria Operations 使用 **vRealizeOpsToken** 身份验证：
```
POST /suite-api/api/auth/token/acquire
{"username": "admin", "password": "...", "authSource": "LOCAL"}
→ {"token": "abc123", "validity": 1765182896000} # validity = expiry epoch ms
后续请求：Authorization: vRealizeOpsToken abc123
```
令牌的有效期为 6 小时（每次调用都会延长，根据官方规范）；客户端在到期前 60 秒自动重新获取。`validity` 字段是到期时间戳（以毫秒为单位的 epoch）。
## 架构
```
用户（自然语言）
↓
AI 代理（Claude Code / Goose / Cursor）
↓ [读取 SKILL.md]
vmware-aria MCP 服务器（stdio 传输）
↓ [HTTPS + vRealizeOpsToken]
Aria Operations 套件 API
↓
虚拟机 / 主机 / 集群 / 警报 / 容量
```
### 配套技能
| 技能 | 范围 | 工具 | 安装 |
|-------|-------|:-----:|---------|
| **[vmware-aiops](https://github.com/zw008/VMware-AIops)** ⭐ 入口 | VM 生命周期，部署，访客操作，集群 | 31 | `uv tool install vmware-aiops` |
| **[vmware-monitor](https://github.com/zw008/VMware-Monitor)** | 只读监控，警报，事件，VM 信息 | 8 | `uv tool install vmware-monitor` |
| **[vmware-nsx](https://github.com/zw008/VMware-NSX)** | NSX 网络：段，网关，NAT，IPAM | 31 | `uv tool install vmware-nsx-mgmt` |
| **[vmware-nsx-security](https://github.com/zw008/VMware-NSX-Security)** | DFW 微分段，安全组，Traceflow | 20 | `uv tool install vmware-nsx-security` |
| **[vmware-storage](https://github.com/zw008/VMware-Storage)** | 数据存储，iSCSI，vSAN | 11 | `uv tool install vmware-storage` |
| **[vmware-vks](https://github.com/zw008/VMware-VKS)** | Tanzu 命名空间，TKC 集群生命周期 | 20 | `uv tool install vmware-vks` |
## 安全
- 密码从环境变量或 `.env` 文件加载，绝不从 `config.yaml` 加载
- 写操作（警报确认/取消，警报定义管理，报告生成/删除）审计日志记录到 `~/.vmware/audit.db`（MCP，通过 vmware-policy）和 `~/.vmware-aria/audit.log`（CLI）
- API 响应已净化（控制字符剥离，500 个字符限制）以防止提示注入
- 支持自签名证书（`verify_ssl: false`）用于实验室环境
#### 官方 Broadcom 参考资料
- **REST API**：<https://developer.broadcom.com/xapis> — VCF Operations API（前身为 Aria Operations suite-api）
- **SDK**：<https://developer.broadcom.com/sdks> — VCF Python SDK
- **CLI 工具**：<https://developer.broadcom.com/tools> — PowerCLI 9.1 包括 "VCF Operations（前身为 vRealize Operations Manager）" cmdlet
## 许可证
MIT — 请参阅 [LICENSE](LICENSE)
