Nmap MCP 서버

이는 nmap 네트워크 스캐닝 기능에 대한 액세스를 제공하는 모델 제어 프로토콜(MCP) 서버입니다.

특징

• 사용자 정의 가능한 옵션을 사용하여 지정된 대상에 대한 nmap 스캔을 실행합니다.
• 스캔 결과 저장 및 검색
• AI 프롬프트를 사용하여 스캔 결과 분석

설치

요구 사항:

• 파이썬 3.10+
• 파이썬-libnmap
• nmap(시스템에 설치됨)

지엑스피1

시스템에 nmap이 설치되어 있는지 확인하세요:

용법

서버 실행

소스 코드에서 직접 서버를 실행하려면:

패키지를 설치하고 명령으로 실행하려면:

사용 가능한 도구

1. 실행-nmap-스캔
   • 지정된 대상에 대해 nmap 스캔을 실행합니다.
   • 매개변수:
     • target : 대상 호스트 또는 네트워크(예: 192.168.1.1 또는 192.168.1.0/24)
     • options : Nmap 옵션(예: -sV -p 1-1000)
2. 스캔 세부 정보 가져오기
   • 특정 스캔에 대한 자세한 정보를 얻으세요
   • 매개변수:
     • scan_id : 검색할 스캔의 ID
3. 모든 스캔 목록
   • 사용 가능한 모든 스캔 결과 나열
   • 매개변수가 필요하지 않습니다

사용 가능한 프롬프트

1. 분석-스캔
   • nmap 스캔 결과 분석
   • 매개변수:
     • scan_id : 분석할 스캔의 ID
     • focus : 집중 분야(보안/서비스/개요)

자원

스캔 결과는 nmap://scan/{scan_id} URI 체계를 사용하여 리소스로 사용할 수 있습니다.

워크플로 예시

1. 검사를 실행하세요:
   Call tool: run-nmap-scan Parameters: {"target": "192.168.1.0/24", "options": "-sV -p 22,80,443"}
2. 스캔 세부 정보 받기:
   Call tool: get-scan-details Parameters: {"scan_id": "<scan_id from previous step>"}
3. 모든 스캔을 나열하세요:
   Call tool: list-all-scans
4. 검사 결과 분석:
   Get prompt: analyze-scan Parameters: {"scan_id": "<scan_id>", "focus": "security"}

보안 고려 사항

이 서버는 사용자 시스템에서 nmap 명령을 실행합니다. 소유하지 않았거나 스캔 권한이 없는 네트워크를 스캔할 때는 주의하십시오. 일부 관할 지역에서는 무단 스캔이 불법일 수 있습니다.

문제 해결

nmap을 찾을 수 없거나 잘못 실행된 것과 관련된 오류가 발생하는 경우:

1. nmap이 설치되어 PATH에 사용 가능한지 확인하세요.
2. nmap 실행 파일이 사용되는 로그를 확인하세요.
3. 서버는 충돌을 피하기 위해 nmap에 대한 전체 경로를 사용하려고 시도합니다.