vmware-aria 1.3.0__tar.gz

vmware_aria-1.3.0/.gitignore

@@ -0,0 +1,19 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+dist/
+*.egg-info/
+.eggs/
+.env
+.venv/
+venv/
+env/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+*.log
+*.sqlite3
+.DS_Store

vmware_aria-1.3.0/Dockerfile

@@ -0,0 +1,13 @@
+FROM python:3.12-slim
+
+WORKDIR /app
+
+RUN pip install --no-cache-dir uv
+
+COPY pyproject.toml .
+COPY vmware_aria/ vmware_aria/
+COPY mcp_server/ mcp_server/
+
+RUN uv pip install --system .
+
+CMD ["python", "-m", "mcp_server"]

vmware_aria-1.3.0/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: vmware-aria
+Version: 1.3.0
+Summary: VMware Aria Operations (vRealize Operations) monitoring, alerting, and capacity planning
+Author: zw008
+License-Expression: MIT
+Keywords: ai-ops,aria,capacity,mcp,monitoring,vmware,vrealize,vrops
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.10
+Requires-Dist: httpx<1.0,>=0.27
+Requires-Dist: mcp[cli]<2.0,>=1.0
+Requires-Dist: python-dotenv<2.0,>=1.0
+Requires-Dist: pyyaml<7.0,>=6.0
+Requires-Dist: rich<15.0,>=13.0
+Requires-Dist: typer<1.0,>=0.12
+Description-Content-Type: text/markdown
+
+# VMware Aria Operations MCP Skill
+
+AI-assisted monitoring and capacity planning for VMware Aria Operations (vRealize Operations) via the Model Context Protocol (MCP).
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Overview
+
+`vmware-aria` exposes 18 MCP tools for interacting with Aria Operations through natural language AI agents (Claude Code, Cursor, Goose, etc.):
+
+| Category | Tools | Type |
+|----------|-------|------|
+| **Resources** | list, get, metrics, health badge, top consumers | Read-only (5) |
+| **Alerts** | list, get, acknowledge, cancel, definitions | Read + 2 Write (5) |
+| **Capacity** | overview, remaining, time-remaining, rightsizing | Read-only (4) |
+| **Anomaly** | list anomalies, risk badge | Read-only (2) |
+| **Health** | platform health, collector groups | Read-only (2) |
+
+**Total**: 18 tools — 16 read-only, 2 write (acknowledge/cancel alerts)
+
+## Quick Start
+
+```bash
+# Install
+uv tool install vmware-aria
+
+# Configure
+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
+
+# Set password (never in config.yaml)
+echo "VMWARE_ARIA_PROD_PASSWORD=your_password" > ~/.vmware-aria/.env
+chmod 600 ~/.vmware-aria/.env
+
+# Verify setup
+vmware-aria doctor
+```
+
+## CLI Examples
+
+```bash
+# List top CPU consumers
+vmware-aria resource top --metric cpu|usage_average --top 10
+
+# Check active CRITICAL alerts
+vmware-aria alert list --criticality CRITICAL
+
+# Acknowledge an alert
+vmware-aria alert acknowledge <alert-id>
+
+# Fetch 4-hour CPU + memory metrics for a VM
+vmware-aria resource metrics <vm-id> --metrics cpu|usage_average,mem|usage_average --hours 4
+
+# Check cluster capacity
+vmware-aria capacity remaining <cluster-id>
+vmware-aria capacity time-remaining <cluster-id>
+
+# Find rightsizing opportunities
+vmware-aria capacity rightsizing
+
+# Check Aria platform health
+vmware-aria health status
+vmware-aria health collectors
+```
+
+## MCP Setup (Claude Code)
+
+Add to `~/.claude.json`:
+
+```json
+{
+  "mcpServers": {
+    "vmware-aria": {
+      "command": "vmware-aria-mcp",
+      "env": {
+        "VMWARE_ARIA_CONFIG": "~/.vmware-aria/config.yaml"
+      }
+    }
+  }
+}
+```
+
+Then use natural language:
+- *"Show me the top 10 CPU consumers right now"*
+- *"List all CRITICAL alerts and acknowledge them"*
+- *"How long until the prod cluster runs out of memory?"*
+- *"Which VMs are over-provisioned? Show rightsizing recommendations"*
+- *"Are there any anomalies on vm-web-01?"*
+
+## Authentication
+
+Aria Operations uses **OpsToken** authentication:
+
+```
+POST /suite-api/api/auth/token/acquire
+{"username": "admin", "password": "...", "authSource": "LOCAL"}
+→ {"token": "abc123", "validity": 1800000}
+
+Subsequent requests: Authorization: OpsToken abc123
+```
+
+Tokens are valid for 30 minutes and automatically refreshed 60 seconds before expiry.
+
+## Architecture
+
+```
+User (natural language)
+  ↓
+AI Agent (Claude Code / Goose / Cursor)
+  ↓  [reads SKILL.md]
+vmware-aria MCP server (stdio transport)
+  ↓  [HTTPS + OpsToken]
+Aria Operations Suite API
+  ↓
+VMs / Hosts / Clusters / Alerts / Capacity
+```
+
+## Companion Skills
+
+| Skill | Purpose |
+|-------|---------|
+| [vmware-aiops](https://github.com/zw008/VMware-AIops) | VM lifecycle: create, clone, snapshot, power |
+| [vmware-nsx](https://github.com/zw008/VMware-NSX) | NSX networking: segments, gateways, NAT, routing |
+| [vmware-monitor](https://github.com/zw008/VMware-Monitor) | Read-only vSphere inventory and events |
+
+## Security
+
+- Passwords loaded from env vars or `.env` file, never from `config.yaml`
+- Write operations (acknowledge/cancel alert) audit-logged to `~/.vmware-aria/audit.log`
+- API responses sanitized (control chars stripped, 500-char limit) to prevent prompt injection
+- Supports self-signed certificates (`verify_ssl: false`) for lab environments
+
+## License
+
+MIT — see [LICENSE](LICENSE)

vmware_aria-1.3.0/README-CN.md

@@ -0,0 +1,137 @@
+# VMware Aria Operations MCP Skill
+
+通过 Model Context Protocol (MCP) 为 VMware Aria Operations（原 vRealize Operations）提供 AI 辅助的监控与容量规划能力。
+
+## 概述
+
+`vmware-aria` 提供 18 个 MCP 工具，支持通过自然语言 AI Agent（Claude Code、Cursor、Goose 等）与 Aria Operations 交互：
+
+| 类别 | 工具 | 类型 |
+|------|------|------|
+| **资源** | 列表、详情、指标、健康评分、高消耗排名 | 只读 (5) |
+| **告警** | 列表、详情、确认、取消、告警定义 | 读+2写 (5) |
+| **容量** | 概览、剩余容量、时间预测、虚拟机调整 | 只读 (4) |
+| **异常** | 异常列表、风险评分 | 只读 (2) |
+| **健康** | 平台健康、采集器状态 | 只读 (2) |
+
+**共 18 个工具** — 16 只读、2 写操作（确认/取消告警）
+
+## 快速开始
+
+```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
+
+# 查看所有严重告警
+vmware-aria alert list --criticality CRITICAL
+
+# 确认告警
+vmware-aria alert acknowledge <alert-id>
+
+# 查询虚拟机 CPU 和内存指标（最近 4 小时）
+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
+```
+
+## MCP 配置（Claude Code）
+
+在 `~/.claude.json` 中添加：
+
+```json
+{
+  "mcpServers": {
+    "vmware-aria": {
+      "command": "vmware-aria-mcp",
+      "env": {
+        "VMWARE_ARIA_CONFIG": "~/.vmware-aria/config.yaml"
+      }
+    }
+  }
+}
+```
+
+然后即可使用自然语言：
+- *"显示当前 CPU 占用最高的 10 台虚拟机"*
+- *"列出所有严重告警并逐一确认"*
+- *"生产集群的内存还够用多少天？"*
+- *"哪些虚拟机资源配置过多？给出调整建议"*
+- *"vm-web-01 上有没有异常检测结果？"*
+
+## 认证机制
+
+Aria Operations 使用 **OpsToken** 认证：
+
+```
+POST /suite-api/api/auth/token/acquire
+Body: {"username": "admin", "password": "...", "authSource": "LOCAL"}
+响应: {"token": "abc123", "validity": 1800000}
+
+后续请求 Header: Authorization: OpsToken abc123
+```
+
+Token 有效期 30 分钟，到期前 60 秒自动刷新。
+
+## 密码命名规则
+
+| 目标名 | 环境变量 |
+|--------|---------|
+| `prod` | `VMWARE_ARIA_PROD_PASSWORD` |
+| `aria-lab` | `VMWARE_ARIA_ARIA_LAB_PASSWORD` |
+| `staging-01` | `VMWARE_ARIA_STAGING_01_PASSWORD` |
+
+规则：`VMWARE_ARIA_<TARGET大写>_PASSWORD`，连字符转为下划线。
+
+## 配套 Skill
+
+| Skill | 用途 |
+|-------|------|
+| [vmware-aiops](https://github.com/zw008/VMware-AIops) | 虚拟机生命周期：创建、克隆、快照、开关机 |
+| [vmware-nsx](https://github.com/zw008/VMware-NSX) | NSX 网络：Segment、网关、NAT、路由 |
+| [vmware-monitor](https://github.com/zw008/VMware-Monitor) | vSphere 只读库存和事件查询 |
+
+## 安全性
+
+- 密码仅从环境变量或 `.env` 文件加载，不存入 `config.yaml`
+- 写操作（确认/取消告警）记录审计日志至 `~/.vmware-aria/audit.log`
+- API 响应经过净化处理（去除控制字符，截断至 500 字符），防止提示注入攻击
+- 支持自签名证书（`verify_ssl: false`），适用于实验环境
+
+## 许可证
+
+MIT

vmware_aria-1.3.0/README.md

@@ -0,0 +1,145 @@
+# VMware Aria Operations MCP Skill
+
+AI-assisted monitoring and capacity planning for VMware Aria Operations (vRealize Operations) via the Model Context Protocol (MCP).
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Overview
+
+`vmware-aria` exposes 18 MCP tools for interacting with Aria Operations through natural language AI agents (Claude Code, Cursor, Goose, etc.):
+
+| Category | Tools | Type |
+|----------|-------|------|
+| **Resources** | list, get, metrics, health badge, top consumers | Read-only (5) |
+| **Alerts** | list, get, acknowledge, cancel, definitions | Read + 2 Write (5) |
+| **Capacity** | overview, remaining, time-remaining, rightsizing | Read-only (4) |
+| **Anomaly** | list anomalies, risk badge | Read-only (2) |
+| **Health** | platform health, collector groups | Read-only (2) |
+
+**Total**: 18 tools — 16 read-only, 2 write (acknowledge/cancel alerts)
+
+## Quick Start
+
+```bash
+# Install
+uv tool install vmware-aria
+
+# Configure
+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
+
+# Set password (never in config.yaml)
+echo "VMWARE_ARIA_PROD_PASSWORD=your_password" > ~/.vmware-aria/.env
+chmod 600 ~/.vmware-aria/.env
+
+# Verify setup
+vmware-aria doctor
+```
+
+## CLI Examples
+
+```bash
+# List top CPU consumers
+vmware-aria resource top --metric cpu|usage_average --top 10
+
+# Check active CRITICAL alerts
+vmware-aria alert list --criticality CRITICAL
+
+# Acknowledge an alert
+vmware-aria alert acknowledge <alert-id>
+
+# Fetch 4-hour CPU + memory metrics for a VM
+vmware-aria resource metrics <vm-id> --metrics cpu|usage_average,mem|usage_average --hours 4
+
+# Check cluster capacity
+vmware-aria capacity remaining <cluster-id>
+vmware-aria capacity time-remaining <cluster-id>
+
+# Find rightsizing opportunities
+vmware-aria capacity rightsizing
+
+# Check Aria platform health
+vmware-aria health status
+vmware-aria health collectors
+```
+
+## MCP Setup (Claude Code)
+
+Add to `~/.claude.json`:
+
+```json
+{
+  "mcpServers": {
+    "vmware-aria": {
+      "command": "vmware-aria-mcp",
+      "env": {
+        "VMWARE_ARIA_CONFIG": "~/.vmware-aria/config.yaml"
+      }
+    }
+  }
+}
+```
+
+Then use natural language:
+- *"Show me the top 10 CPU consumers right now"*
+- *"List all CRITICAL alerts and acknowledge them"*
+- *"How long until the prod cluster runs out of memory?"*
+- *"Which VMs are over-provisioned? Show rightsizing recommendations"*
+- *"Are there any anomalies on vm-web-01?"*
+
+## Authentication
+
+Aria Operations uses **OpsToken** authentication:
+
+```
+POST /suite-api/api/auth/token/acquire
+{"username": "admin", "password": "...", "authSource": "LOCAL"}
+→ {"token": "abc123", "validity": 1800000}
+
+Subsequent requests: Authorization: OpsToken abc123
+```
+
+Tokens are valid for 30 minutes and automatically refreshed 60 seconds before expiry.
+
+## Architecture
+
+```
+User (natural language)
+  ↓
+AI Agent (Claude Code / Goose / Cursor)
+  ↓  [reads SKILL.md]
+vmware-aria MCP server (stdio transport)
+  ↓  [HTTPS + OpsToken]
+Aria Operations Suite API
+  ↓
+VMs / Hosts / Clusters / Alerts / Capacity
+```
+
+## Companion Skills
+
+| Skill | Purpose |
+|-------|---------|
+| [vmware-aiops](https://github.com/zw008/VMware-AIops) | VM lifecycle: create, clone, snapshot, power |
+| [vmware-nsx](https://github.com/zw008/VMware-NSX) | NSX networking: segments, gateways, NAT, routing |
+| [vmware-monitor](https://github.com/zw008/VMware-Monitor) | Read-only vSphere inventory and events |
+
+## Security
+
+- Passwords loaded from env vars or `.env` file, never from `config.yaml`
+- Write operations (acknowledge/cancel alert) audit-logged to `~/.vmware-aria/audit.log`
+- API responses sanitized (control chars stripped, 500-char limit) to prevent prompt injection
+- Supports self-signed certificates (`verify_ssl: false`) for lab environments
+
+## License
+
+MIT — see [LICENSE](LICENSE)

vmware_aria-1.3.0/RELEASE_NOTES.md

@@ -0,0 +1,55 @@
+# Release Notes
+
+## v1.3.0 (2026-03-27)
+
+Initial release of `vmware-aria` — VMware Aria Operations AI monitoring skill.
+
+### Features
+
+**Resource Monitoring (5 tools)**
+- `list_resources` — List VMs, hosts, clusters, datastores by resource kind with health badge
+- `get_resource` — Full resource details including health, risk, and efficiency badge scores
+- `get_resource_metrics` — Time-series metric stats with configurable window and rollup type
+- `get_resource_health` — Health badge score (0–100) with color and description
+- `get_top_consumers` — Rank VMs or hosts by CPU, memory, disk, or network usage
+
+**Alert Management (5 tools)**
+- `list_alerts` — Active or all alerts with criticality and resource scope filtering
+- `get_alert` — Full alert details: symptom list, recommendations, timeline
+- `acknowledge_alert` — Mark alert as acknowledged (write, audit-logged)
+- `cancel_alert` — Dismiss an active alert (write, audit-logged)
+- `list_alert_definitions` — Browse alert definition templates
+
+**Capacity Planning (4 tools)**
+- `get_capacity_overview` — Cluster capacity recommendations
+- `get_remaining_capacity` — Remaining CPU, memory, disk headroom
+- `get_time_remaining` — Days until capacity dimensions are exhausted
+- `list_rightsizing_recommendations` — Over/under-provisioned VM recommendations
+
+**Anomaly Detection (2 tools)**
+- `list_anomalies` — ML-detected metric anomalies, per-resource or global
+- `get_resource_riskbadge` — Risk score with contributing causes
+
+**Platform Health (2 tools)**
+- `get_aria_health` — All Aria internal service states
+- `list_collector_groups` — Remote collector agent status
+
+### Authentication
+- OpsToken authentication: `POST /suite-api/api/auth/token/acquire`
+- Auto-refresh: token refreshed 60s before 30-minute expiry
+- Supports LOCAL, LDAP, and AD authentication sources
+
+### Security
+- Passwords loaded from env vars / `.env` file only
+- All API text sanitized (control chars stripped, 500-char max)
+- Write operations (acknowledge/cancel) audit-logged to `~/.vmware-aria/audit.log`
+
+### CLI
+- Full CLI with 5 command groups: `resource`, `alert`, `capacity`, `anomaly`, `health`
+- `vmware-aria doctor` — pre-flight diagnostics for config, network, auth, MCP import
+- Rich table output for list commands, JSON output for detail commands
+
+### Compatibility
+- Python 3.10+
+- Aria Operations 8.x (vRealize Operations 8.x)
+- Suite API v2 (`/suite-api/api/`)

vmware_aria-1.3.0/config.example.yaml

@@ -0,0 +1,23 @@
+# VMware Aria Operations Configuration
+# Copy to ~/.vmware-aria/config.yaml and edit
+
+targets:
+  prod:
+    host: aria-ops.example.com
+    username: admin
+    port: 443
+    verify_ssl: true
+    auth_source: LOCAL   # LOCAL | LDAP | AD
+  lab:
+    host: 10.0.0.100
+    username: admin
+    port: 443
+    verify_ssl: false
+    auth_source: LOCAL
+
+default_target: prod
+
+# Passwords are loaded from environment variables:
+# VMWARE_ARIA_PROD_PASSWORD=xxx
+# VMWARE_ARIA_LAB_PASSWORD=xxx
+# Or from ~/.vmware-aria/.env file

vmware_aria-1.3.0/docker-compose.yml

@@ -0,0 +1,8 @@
+services:
+  vmware-aria-mcp:
+    build: .
+    volumes:
+      - ~/.vmware-aria:/root/.vmware-aria:ro
+    environment:
+      - VMWARE_ARIA_CONFIG=/root/.vmware-aria/config.yaml
+    stdin_open: true

vmware_aria-1.3.0/examples/mcp-configs/claude-code.json

@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "vmware-aria": {
+      "command": "vmware-aria-mcp",
+      "env": {
+        "VMWARE_ARIA_CONFIG": "~/.vmware-aria/config.yaml"
+      }
+    }
+  }
+}

vmware_aria-1.3.0/examples/mcp-configs/cursor.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "vmware-aria": {
+      "command": "vmware-aria-mcp",
+      "env": {
+        "VMWARE_ARIA_CONFIG": "/Users/<your-username>/.vmware-aria/config.yaml",
+        "VMWARE_ARIA_PROD_PASSWORD": "<your-password>"
+      }
+    }
+  }
+}

vmware_aria-1.3.0/examples/mcp-configs/goose.json

@@ -0,0 +1,11 @@
+{
+  "extensions": {
+    "vmware-aria": {
+      "type": "stdio",
+      "cmd": "vmware-aria-mcp",
+      "env": {
+        "VMWARE_ARIA_CONFIG": "~/.vmware-aria/config.yaml"
+      }
+    }
+  }
+}

vmware_aria-1.3.0/mcp_server/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as `python -m mcp_server`."""
+
+from mcp_server.server import main
+
+main()