{
  "markdown": "<!-- mcp-name: io.github.vmware-skills/vmware-pilot -->\n\n# VMware Pilot\n\n> **Author**: Wei Zhou, VMware by Broadcom — wei-wz.zhou@broadcom.com\n> This is a community-driven project by a VMware engineer, not an official VMware product.\n> For official VMware developer tools see [developer.broadcom.com](https://developer.broadcom.com).\n\nEnglish | [中文](README-CN.md)\n\nMulti-step workflow orchestration for VMware MCP skills — state machine, approval gates, audit trail.\n\n> **Companion skills** handle everything else:\n>\n> | Skill | Scope | Install |\n> |-------|-------|---------|\n> | **[vmware-aiops](https://github.com/vmware-skills/VMware-AIops)** | VM lifecycle, deployment, guest ops, cluster | `uv tool install vmware-aiops` |\n> | **[vmware-monitor](https://github.com/vmware-skills/VMware-Monitor)** | Read-only: inventory, health, alarms, events | `uv tool install vmware-monitor` |\n> | **[vmware-storage](https://github.com/vmware-skills/VMware-Storage)** | Datastores, iSCSI, vSAN management | `uv tool install vmware-storage` |\n> | **[vmware-vks](https://github.com/vmware-skills/VMware-VKS)** | Tanzu Namespaces, TKC cluster lifecycle | `uv tool install vmware-vks` |\n> | **[vmware-nsx](https://github.com/vmware-skills/VMware-NSX)** | NSX networking: segments, gateways, NAT | `uv tool install vmware-nsx-mgmt` |\n> | **[vmware-nsx-security](https://github.com/vmware-skills/VMware-NSX-Security)** | DFW firewall rules, security groups | `uv tool install vmware-nsx-security` |\n> | **[vmware-aria](https://github.com/vmware-skills/VMware-Aria)** | Aria Ops: metrics, alerts, capacity | `uv tool install vmware-aria` |\n> | **[vmware-avi](https://github.com/vmware-skills/VMware-AVI)** | AVI load balancing, pool management, AKO K8s ops | `uv tool install vmware-avi` |\n\n## Install\n\n```bash\nuv tool install vmware-pilot\nvmware-pilot mcp          # start the MCP server (stdio)\n```\n\n### Offline / Air-Gapped Install (from source)\n\nThis project uses the modern PEP 517 build system (hatchling), so there is **no\n`setup.py`** by design — that is expected, not a missing file. If you cloned the\nsource and hit `ERROR: File \"setup.py\" or \"setup.cfg\" not found ... editable mode\ncurrently requires a setuptools-based build`, your `pip` is older than 21.3 and\ncannot do an *editable* (`-e`) install with a non-setuptools backend. Editable\nmode is a developer convenience, not needed to run the tool — do one of:\n\n```bash\n# From the source tree — a normal (non-editable) install builds a wheel:\npip install .              # NOT  pip install -e .\n\n# ...or upgrade pip first, and editable works too:\npip install --upgrade pip && pip install -e .\n```\n\nFor a **truly air-gapped host**, build the wheels on a connected machine and copy\nthem over — the target then needs no network:\n\n```bash\n# On a connected machine, collect this package + its dependencies as wheels:\npip wheel . -w dist        # → dist/*.whl   (or: uv build, for just this package)\n\n# Copy dist/ to the air-gapped host, then install offline:\npip install --no-index --find-links dist vmware-pilot\n```\n\n## MCP Tools (13 — 4 read, 9 write)\n\n| Tool | Description |\n|------|-------------|\n| `get_skill_catalog` | List all available skills and tools for workflow design |\n| `list_workflows` | List built-in and custom templates |\n| `review_workflow` | Sanity-check a planned workflow before execution |\n| `design_workflow` | Natural language goal → draft workflow |\n| `update_draft` | Edit draft workflow steps |\n| `confirm_draft` | Finalize draft → ready to execute |\n| `plan_workflow` | Generate execution plan from template, returns workflow_id |\n| `create_workflow` | Create custom workflow from step list |\n| `run_workflow` | Execute workflow, pauses at approval gates |\n| `get_workflow_status` | Query state + diff report + audit log |\n| `approve` | Human approval, continue execution |\n| `rollback` | Abort and rollback at any stage |\n| `cancel_workflow` | Cancel a workflow — move it to the terminal CANCELLED state |\n\n## MCP Configuration\n\n```json\n{\n  \"mcpServers\": {\n    \"vmware-pilot\": {\n      \"command\": \"vmware-pilot\",\n      \"args\": [\"mcp\"]\n    }\n  }\n}\n```\n\n> Fallback: `{\"command\": \"uvx\", \"args\": [\"--from\", \"vmware-pilot\", \"vmware-pilot-mcp\"]}` still\n> works, but `uvx` re-resolves against PyPI on every start and fails behind a TLS-inspecting\n> corporate proxy (`invalid peer certificate: UnknownIssuer`). The installed entry point above\n> touches the network zero times; set `UV_NATIVE_TLS=true` if you must use `uvx`.\n\n## License\n\nMIT",
  "bytes": 4507,
  "sha": "4e60ef0634b52d043c855f0cc8e736c79331700d26e7cd05de2a03ea2d707139",
  "repo_slug": "zw008/vmware-pilot",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_zw008_vmware_pilot_63b9d4b7/readme"
}