convez.ai
PluginSegurançaAvançado
zw008

VMware NSX Security MCP

zw008/VMware-NSX-Security

21 ferramentas MCP para microsegmentação e segurança VMware NSX

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin MCP que expõe 21 ferramentas para microsegmentação e segurança em VMware NSX, incluindo políticas de firewall distribuído (DFW), grupos de segurança, tags de VM, rastreamento de pacotes (Traceflow) e detecção/prevenção de intrusão (IDPS). Permite automação completa de segurança de rede via agentes Claude.

Instalação

$npx convez-ai zw008/VMware-NSX-Security

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 dias
Versão
v1.17.3
Issues abertas
0
Contribuidores
4

Casos de uso

  • Automatizar criação e gestão de políticas DFW e regras de firewall distribuído
  • Implementar microsegmentação de aplicações via grupos de segurança e tags
  • Rastrear e diagnosticar fluxos de pacotes com Traceflow em tempo real
  • Gerenciar perfis IDPS e status de assinaturas de segurança

Veredito

Plugin maduro e bem documentado para infraestrutura NSX, criado por engenheiro VMware. Cobre end-to-end de segurança de rede (DFW, microsegmentação, IDPS), ideal para equipes DevSecOps e arquitetos de segurança que precisam automatizar políticas NSX via Claude.

README

A tradução para o português deste README ainda está na fila.

VMware NSX Security

Author: Wei Zhou, VMware by Broadcom — wei-wz.zhou@broadcom.com This is a community-driven project by a VMware engineer, not an official VMware product. For official VMware developer tools see developer.broadcom.com.

VMware NSX DFW microsegmentation and security MCP skill — 21 tools for distributed firewall policies/rules, security groups, VM tags, Traceflow packet tracing, and IDPS.

Companion skills: vmware-nsx (networking), vmware-aiops (VM lifecycle), vmware-monitor (monitoring)

Quick Start

uv tool install vmware-nsx-security

mkdir -p ~/.vmware-nsx-security
cp config.example.yaml ~/.vmware-nsx-security/config.yaml
# Edit config.yaml with your NSX Manager host

echo "VMWARE_NSX_SECURITY_NSX_PROD_PASSWORD=your_password" > ~/.vmware-nsx-security/.env
chmod 600 ~/.vmware-nsx-security/.env

vmware-nsx-security doctor

What It Does

CategoryTools
DFW Policylist, get, create, update, delete, list rules
DFW Rulescreate, update, delete, stats
Security Groupslist, get, create, delete
VM Tagslist tags, apply tag, remove tag
Traceflowrun trace, get result
IDPSlist profiles, signature status + settings

Total: 21 MCP tools (10 read-only + 11 write)

MCP Server Setup

After uv tool install vmware-nsx-security, start the MCP server with one command (v1.5.15+):

# Recommended — single command, no network re-resolve
vmware-nsx-security mcp

# With a custom config path
VMWARE_NSX_SECURITY_CONFIG=/path/to/config.yaml vmware-nsx-security mcp

Add to ~/.claude.json:

{
  "mcpServers": {
    "vmware-nsx-security": {
      "command": "vmware-nsx-security",
      "args": ["mcp"],
      "env": {
        "VMWARE_NSX_SECURITY_CONFIG": "~/.vmware-nsx-security/config.yaml"
      }
    }
  }
}
# Run without installing (requires PyPI access each launch)
uvx --from vmware-nsx-security vmware-nsx-security mcp

# Legacy entry point (still works, kept for backward compatibility)
vmware-nsx-security-mcp

Behind a corporate TLS proxy? uvx may fail with invalid peer certificate: UnknownIssuer. Use the recommended vmware-nsx-security mcp form above (no network needed), or set UV_NATIVE_TLS=true.

Common Workflows

Microsegment an Application

# 1. Create groups by tag — via the create_group MCP tool
#    (tag_scope=tier, tag_value=web → matched as Condition value "tier|web";
#     multiple criteria types — tag/IP/segment — are ORed)

# 2. Create DFW policy
vmware-nsx-security policy create web-app-policy --name "Web to App" --category Application

Tag a VM

# Find VM and its external ID
vmware-nsx-security tag list my-vm-01

# Apply tag using the external ID
vmware-nsx-security tag apply <external-id> --scope tier --value web

Trace a Packet

vmware-nsx-security traceflow run <src-lport-id> \
  --src-ip 10.0.1.5 --dst-ip 10.0.2.10 --proto TCP --dst-port 443

Output reports operation_state (IN_PROGRESS/FINISHED/FAILED), hop-by-hop observations discriminated by resource_type (Dropped* entries carry reason + acl_rule_id), and a dfw_hits summary.

Safety

  • Dependency checks: Cannot delete a policy with active rules, or a group referenced by DFW rules/scopes; group deletion aborts if the reference scan fails
  • Audit logging: All write ops logged to ~/.vmware-nsx-security/audit.log
  • Input validation: IDs validated; all API text sanitized against prompt injection
  • Dry-run mode: All CLI write commands support --dry-run
  • Credential safety: Passwords only from env vars, never in config files

Companion Skills

SkillScopeToolsInstall
vmware-aiops ⭐ entry pointVM lifecycle, deployment, guest ops, clusters31uv tool install vmware-aiops
vmware-monitorRead-only monitoring, alarms, events, VM info8uv tool install vmware-monitor
vmware-nsxNSX networking: segments, gateways, NAT, IPAM31uv tool install vmware-nsx-mgmt
vmware-storageDatastores, iSCSI, vSAN11uv tool install vmware-storage
vmware-vksTanzu Namespaces, TKC cluster lifecycle20uv tool install vmware-vks
vmware-ariaAria Ops metrics, alerts, capacity planning18uv tool install vmware-aria

Version Compatibility

NSX VersionSupportNotes
NSX 9.1 / VCF 9.1✅ FullDFW + Security Group + Traceflow + IDS/IPS via Policy API. VDS 7.0+ required (N-VDS removed in NSX 9).
NSX 9.0 / VCF 9.0✅ FullSame as 9.1. Bare-metal NSX agent removed.
NSX 4.x / VCF 5.x✅ FullAll features supported.
NSX-T 3.2 / VCF 4.5✅ FullPolicy API stable.

Official Broadcom References

License

MIT

Ver o original no GitHub

Bom para

Relacionados