fortinac-mcp

Von KI generierter Code (vibe-coded) / Von KI vollständig generierter Code

MCP-Server zum Diagnostizieren von Rogue-Hosts auf FortiNAC 7.6.

Fragt die FortiNAC-REST-API ab, gleicht jedes Gerät mit den Profiling-Regeln ab und führt nmap-Scans durch, um genau zu identifizieren, welche Bedingungen die Klassifizierung blockieren.

Voraussetzungen

• Python 3.10+

• nmap (brew install nmap)

• Ein FortiNAC-API-Token mit Lesezugriff auf Hosts und Profiling-Regeln

Related MCP server: MCP Network Tools

Installation

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

Konfiguration

In ~/.mcp.json hinzufügen:

{
  "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"
    }
  }
}

Claude Code neu starten, um den Server zu laden.

Werkzeuge

• check_status -- prüft die API-Verbindung und die Verfügbarkeit von nmap

• list_rogues -- listet die Rogue-Hosts auf (MAC, IP, Vendor, VLAN)

• diagnose_rogues -- Batch-Diagnose: testet jeden Rogue-Host gegen alle Profiling-Regeln

• diagnose_host -- Diagnose eines Hosts anhand der MAC-Adresse

• scan_host -- nmap-Scan auf einer IP (Ports, Dienste, OS)

• lookup_vendor -- sucht den Hersteller anhand einer MAC-Adresse

• get_profiling_rules -- exportiert die Profiling-Regeln aus FortiNAC

• get_host_details -- vollständige Details eines Hosts

• reprofile_all_rogues -- startet die Neubewertung der Rogue-Hosts seitens FortiNAC

Diagnose

Für jeden Rogue prüft diagnose_rogues:

• Vendor OUI (MAC-Übereinstimmung / erwarteter Hersteller)

• Offene Ports via nmap (vs. von der Regel benötigte Ports)

• DHCP-Fingerprint (Vorhandensein und Übereinstimmung)

• SNMP-OID (Antwort und erwarteter Wert)

• IP-Bereich (korrektes Subnetz)

• Standort (Netzwerkplatzierung)

Der Bericht zeigt, welche Bedingungen erfüllt sind, welche fehlschlagen, und schlägt Korrekturmaßnahmen vor.