VMware Aria MCP 技能(vmware-aria)为 AI 智能体提供与 VMware Aria Operations(旧称 vRealize Operations,在 VCF 9.0+ 中更名为 VCF Operations)交互的能力,通过 Model Context Protocol(MCP)实现自然语言驱动的监控、告警和容量规划。项目由 Wei Zhou(VMware by Broadcom)创建,属于社区驱动项目,并非官方 VMware 产品。
用途 该技能用于对 vSphere 环境进行 AI 辅助的监控与容量规划。用户可以用自然语言向 AI 智能体提出查询,例如:查询当前 CPU 消耗最高的 10 个对象、列出所有 CRITICAL 告警并确认、预测生产集群内存耗尽时间、查找配置过度的虚拟机并给出合理规模建议、检查某虚拟机是否存在异常。
主要能力 共提供 44 个 MCP 工具,其中 34 个为只读工具,10 个为写入工具。2.0 版本重命名了 4 个工具,使其名称以动词开头(如 findings_list 改为 list_findings,fleet_certificate_list 改为 list_fleet_certificates,fleet_domain_list 改为 list_fleet_domains),完整对照表见 RELEASE_NOTES.md。重命名之外,工具、参数、安全门控和 CLI 命令均保持不变。若智能体提示、脚本或 ~/.vmware/rules.yaml 中引用了工具名,需要更新;使用旧名称编写的拒绝规则在 vmware-policy ≥ 1.18 下仍可工作,vmware-pilot ≥ 1.13 会在保存的工作流中翻译旧名称。
使用方式 支持在线安装与离线/气隙安装。项目使用 PEP 517 构建系统(hatchling),刻意不提供 setup.py。若克隆源码后遇到 setup.py 或 setup.cfg 未找到的错误,说明 pip 版本低于 21.3,无法以非 setuptools 后端进行可编辑安装;可编辑模式仅为开发者便利,运行工具并不需要。对于真正气隙的主机,可在联网机器上构建 wheel 并复制过去,目标机无需网络。安装后,在 ~/.claude.json 中添加 MCP 配置即可使用。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 形式。
认证与安全 Aria Operations 使用 vRealizeOpsToken 认证,令牌具有 6 小时滑动有效期(每次调用时延长,依据官方规范),客户端会在到期前 60 秒自动重新获取;validity 字段是 epoch 毫秒表示的到期时间戳,而非持续时间。密码从环境变量或 .env 文件加载,绝不从 config.yaml 读取。每次 MCP 工具调用和每个到达 Aria 的 CLI 命令都会通过 vmware-policy 审计记录到 ~/.vmware/audit.db;CLI 写操作(告警确认/取消、告警注释、告警定义管理、报告生成/删除、资源维护开始/结束)还会追加到 ~/.vmware-aria/audit.log。API 响应经过净化(去除控制字符,限制 500 字符)以防止提示注入。MCP 破坏性写入(告警确认/取消、告警定义和报告删除、维护开始/结束)需要 confirm 参数(默认 false):未提供 confirm=true 时,会返回将变更内容的 blast_radius 而不做任何更改;在存在阻塞条件(例如资源已在维护中)或字段不可读时,confirm=true 会被拒绝。confirmed 是已弃用的别名。TLS 验证默认开启;对于私有 CA,将 SSL_CERT_FILE 设置为包含 CA 的证书包;verify_ssl: false 仅用于隔离的自签名实验室环境。
适用场景与限制 适用于使用 Claude Code、Cursor、Goose 等 AI 智能体的 vSphere 管理员和运维人员,进行监控、告警处理和容量规划。限制包括:非官方 VMware 产品,无官方支持;需要 Aria Operations 环境及有效令牌;写操作受安全门控限制;部分版本兼容性需注意(如旧安装共享 rules.yaml 时需 vmware-policy ≥ 1.18.2)。更多官方资源可参考 developer.broadcom.com 上的 REST API、SDK 和 CLI 工具(PowerCLI 9.1 包含 VCF Operations 命令)。