fortinac-mcp

Código generado por IA (vibe-coded) / Código enteramente generado por IA

Servidor MCP para diagnosticar los rogue hosts en FortiNAC 7.6.

Interroga la API REST de FortiNAC, cruza cada dispositivo contra las profiling rules, y lanza escaneos nmap para identificar precisamente qué condiciones bloquean la clasificación.

Prerrequisitos

• Python 3.10+

• nmap (brew install nmap)

• Un token API de FortiNAC con acceso de lectura a los hosts y a las profiling rules

Related MCP server: MCP Network Tools

Instalación

cd fortinac-mcp
python3 -m venv .venv
.venv/bin/pip install -e .

Configuración

Agregar en ~/.mcp.json:

{
  "fortinac": {
    "type": "stdio",
    "command": "/chemin/vers/fortinac-mcp/.venv/bin/python",
    "args": ["-m", "fortinac_mcp"],
    "env": {
      "FORTINAC_URL": "https://fortinac.example.com",
      "FORTINAC_TOKEN": "votre-token-api",
      "FORTINAC_VERIFY_SSL": "false"
    }
  }
}

Reiniciar Claude Code para cargar el servidor.

Herramientas

• check_status -- verifica la conexión API y la disponibilidad de nmap

• list_rogues -- lista los rogue hosts (MAC, IP, fabricante, VLAN)

• diagnose_rogues -- diagnóstico por lotes: prueba cada rogue contra todas las profiling rules

• diagnose_host -- diagnóstico de un host por dirección MAC

• scan_host -- escaneo nmap en una IP (puertos, servicios, SO)

• lookup_vendor -- busca el fabricante a partir de una dirección MAC

• get_profiling_rules -- exporta las reglas de profiling desde FortiNAC

• get_host_details -- detalles completos de un host

• reprofile_all_rogues -- relanza la evaluación de los rogues del lado de FortiNAC

Diagnóstico

Para cada rogue, diagnose_rogues verifica:

• OUI del fabricante (correspondencia MAC / fabricante esperado)

• Puertos abiertos via nmap (vs puertos requeridos por la regla)

• Huella DHCP (presencia y correspondencia)

• OID SNMP (respuesta y valor esperado)

• Rango IP (subred correcta)

• Ubicación (emplazamiento de red)

El informe indica las condiciones que pasan, las que fallan, y propone acciones correctivas.