Nmap MCP Server

Servidor MCP de Nmap

Este es un servidor de Protocolo de Control de Modelos (MCP) que proporciona acceso a la funcionalidad de escaneo de red de nmap.

Características

• Ejecute escaneos nmap en objetivos específicos con opciones personalizables
• Almacenar y recuperar resultados de escaneo
• Analice los resultados del escaneo mediante indicaciones de IA

Instalación

Requisitos:

• Python 3.10+
• python-libnmap
• nmap (instalado en el sistema)

Asegúrese de que nmap esté instalado en su sistema:

Uso

Ejecución del servidor

Para ejecutar el servidor directamente desde el código fuente:

Para instalar el paquete y ejecutarlo como comando:

Herramientas disponibles

1. ejecutar-nmap-scan
   • Ejecutar un escaneo nmap en objetivos específicos
   • Parámetros:
     • target : host o red de destino (por ejemplo, 192.168.1.1 o 192.168.1.0/24)
     • options : opciones de Nmap (por ejemplo, -sV -p 1-1000)
2. obtener detalles del escaneo
   • Obtenga información detallada sobre un escaneo específico
   • Parámetros:
     • scan_id : ID del escaneo a recuperar
3. lista-todos-los-escaneos
   • Listar todos los resultados de escaneo disponibles
   • No se requieren parámetros

Indicaciones disponibles

1. analizar-escanear
   • Analizar un resultado de escaneo de nmap
   • Parámetros:
     • scan_id : ID del escaneo a analizar
     • focus : Área de enfoque (seguridad/servicios/descripción general)

Recursos

Los resultados del escaneo están disponibles como recursos con el esquema URI nmap://scan/{scan_id} .

Ejemplo de flujo de trabajo

1. Ejecutar un escaneo:
   Call tool: run-nmap-scan Parameters: {"target": "192.168.1.0/24", "options": "-sV -p 22,80,443"}
2. Obtener detalles del escaneo:
   Call tool: get-scan-details Parameters: {"scan_id": "<scan_id from previous step>"}
3. Listar todos los escaneos:
   Call tool: list-all-scans
4. Analizar los resultados del escaneo:
   Get prompt: analyze-scan Parameters: {"scan_id": "<scan_id>", "focus": "security"}

Consideraciones de seguridad

Este servidor ejecuta comandos nmap en su sistema. Tenga cuidado al escanear redes que no le pertenecen o para las que no tiene permiso, ya que el escaneo no autorizado puede ser ilegal en algunas jurisdicciones.

Solución de problemas

Si encuentra errores relacionados con que nmap no se encuentra o se ejecuta incorrectamente:

1. Asegúrese de que nmap esté instalado y disponible en su PATH
2. Verifique los registros para los cuales se está utilizando el ejecutable nmap
3. El servidor intentará utilizar la ruta completa a nmap para evitar conflictos

Uso de Docker

Puede ejecutar el servidor MCP en un contenedor Docker:

Para la integración con el directorio Glama MCP, el contenedor Docker permite que otros utilicen fácilmente este servidor MCP sin preocuparse por las dependencias de instalación.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.