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

Related MCP server: Nmap MCP Server

Instalación

Requisitos:

• Python 3.10+

• python-libnmap

• nmap (instalado en el sistema)

pip install python-libnmap

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

# On Debian/Ubuntu
sudo apt-get install nmap

# On Fedora/CentOS
sudo dnf install nmap

Uso

Ejecución del servidor

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

python -m src.nmap_mcp

Para instalar el paquete y ejecutarlo como comando:

pip install -e .
nmap-mcp

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:

# Build the Docker image
docker build -t nmap-mcp-server .

# Run the Docker container
docker run -it --rm nmap-mcp-server

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.