用途
VMware NSX 是一个面向 NSX-T 3.0+ 和 NSX 4.x 的 NSX Policy API 技能，用于通过 AI 智能体或命令行管理 VMware NSX 网络。项目由 VMware by Broadcom 工程师 Wei Zhou 发起，属于社区驱动项目，并非官方 VMware 产品。官方 VMware 开发者工具可参考 developer.broadcom.com。
主要能力
该技能共提供 33 个 MCP 工具，其中 20 个为只读工具、13 个为写入工具，按领域聚焦组织，覆盖以下网络管理对象：
- 网段（segments）
- 网关（gateways），包括 Tier-0 与 Tier-1
- NAT 规则
- 路由（静态路由与 BGP）
- IPAM 池
完整的分工具端点与方法说明位于 skills/vmware-nsx/references/capabilities.md。
使用方式
安装与启动
项目使用现代 PEP 517 构建系统（hatchling），因此设计上没有 setup.py，这是预期行为而非文件缺失。如果克隆源码后遇到 “ERROR: File "setup.py" or "setup.cfg" not found ... editable mode currently requires a setuptools-based build”，说明 pip 版本低于 21.3，无法对非 setuptools 后端执行可编辑（-e）安装。可编辑模式只是开发者便利功能，运行工具并不需要。
对于完全离线/气隙主机，可先在联网机器上构建 wheel 并复制过去，目标主机无需网络。
安装命令：uv tool install vmware-nsx-mgmt
安装后（v1.5.15+）可用一条命令启动 MCP 服务器。
智能体配置
将相应配置加入 AI 智能体的 MCP 配置中。更多智能体配置模板（Claude Code、Cursor、Goose、Continue 等）见 examples/mcp-configs/。
若处于企业 TLS 代理之后，uvx 可能报错 “invalid peer certificate: UnknownIssuer”。建议使用上文推荐的 vmware-nsx mcp 形式（无需网络），或设置 UV_NATIVE_TLS=true。
常见工作流
创建应用网络（网段 + T1 网关 + NAT）
- 创建网关：vmware-nsx gateway create-t1 app-t1 --edge-cluster edge-cluster-01 --tier0 tier0-gw
- 创建网段：vmware-nsx segment create app-web-seg --name app-web-seg --tz <tz-overlay-path> --subnet 10.10.1.1/24
- 添加 SNAT：vmware-nsx nat create app-t1 --action SNAT --source 10.10.1.0/24 --translated 172.16.0.10
- 验证：vmware-nsx segment list 与 vmware-nsx nat list app-t1
任何写入命令前可先用 --dry-run 预览。
检查网络健康
- 管理器状态：vmware-nsx health manager-status
- 传输节点：vmware-nsx health transport-nodes
- 边缘集群：vmware-nsx health edge-clusters
- 告警：vmware-nsx health alarms --severity HIGH（精确匹配过滤；需按严重级别分别查询）
排查虚拟机连通性
- 查找虚拟机所在网段：vmware-nsx troubleshoot vm-segment <vm-display-name>
- 检查端口实现状态：vmware-nsx troubleshoot port-status <segment-id>（该网段上所有端口：attachment、realized bindings、传输节点）
- 检查路由：vmware-nsx gateway routes-t1 app-t1
- 检查 BGP：vmware-nsx gateway bgp-neighbors tier0-gw
适用场景
- 通过 AI 智能体或 CLI 自动化管理 NSX 网段、网关、NAT、路由与 IPAM
- 快速检查 NSX 管理器、传输节点、边缘集群与告警的健康状态
- 排查虚拟机连通性问题，定位网段、端口实现状态、路由与 BGP 邻居
- 在气隙/离线环境中部署使用
限制与说明
- 项目为社区驱动，非官方 VMware 产品。
- 面向 NSX-T 3.0+ 与 NSX 4.x，使用 Policy API 子集。
- 可编辑安装需要 pip 21.3 及以上版本。
- 企业 TLS 代理环境下 uvx 可能因证书问题失败，需改用无需网络的形式或设置 UV_NATIVE_TLS=true。
- 告警严重级别过滤为精确匹配，需按级别分别查询。
- 版本兼容性、VCF 兼容性、SDK、REST API 与 CLI 工具等更多信息，资料中仅给出官方链接（developer.broadcom.com 下的 sdks、xapis、tools），未提供具体兼容矩阵细节。
- 安全策略相关内容资料中未展开。
