fortinac-mcp

AI로 생성된 코드 (vibe-coded) / 전적으로 AI로 생성된 코드

FortiNAC 7.6의 rogue hosts를 진단하기 위한 MCP 서버입니다.

FortiNAC REST API를 조회하고, 각 device를 profiling rules와 대조하며, nmap 스캔을 실행하여 분류를 차단하는 조건을 정확히 식별합니다.

전제 조건

• Python 3.10+

• nmap (brew install nmap)

• hosts 및 profiling rules에 대한 읽기 액세스 권한이 있는 FortiNAC API 토큰

Related MCP server: MCP Network Tools

설치

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

설정

~/.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"
    }
  }
}

서버를 로드하려면 Claude Code를 다시 시작하세요.

도구

• check_status -- API 연결 및 nmap 사용 가능 여부를 확인합니다.

• list_rogues -- rogue hosts 목록 (MAC, IP, vendor, VLAN)

• diagnose_rogues -- 일괄 진단: 각 rogue를 모든 profiling rules에 대해 테스트합니다.

• diagnose_host -- MAC 주소로 host 진단

• scan_host -- IP에 대한 nmap 스캔 (ports, services, OS)

• lookup_vendor -- MAC 주소로 제조업체 검색

• get_profiling_rules -- FortiNAC에서 profiling 규칙 내보내기

• get_host_details -- host의 전체 세부 정보

• reprofile_all_rogues -- FortiNAC 측에서 rogue 평가를 다시 실행합니다.

진단

각 rogue에 대해 diagnose_rogues는 다음을 확인합니다:

• Vendor OUI (MAC 대응 / 예상 제조업체)

• nmap을 통한 열린 포트 (규칙에 필요한 포트와 비교)

• DHCP fingerprint (존재 및 일치)

• SNMP OID (응답 및 예상 값)

• IP range (올바른 서브넷)

• Location (네트워크 배치)

보고서는 통과하는 조건과 실패하는 조건을 표시하고 수정 조치를 제안합니다.