Servidor MCP DNStwist

Un servidor de Protocolo de Contexto de Modelo (MCP) para dnstwist , una potente herramienta de fuzzing de DNS que ayuda a detectar errores tipográficos, phishing y espionaje corporativo. Este servidor proporciona herramientas para analizar permutaciones de dominios e identificar dominios potencialmente maliciosos. Está diseñado para integrarse a la perfección con aplicaciones compatibles con MCP como Claude Desktop .

⚠️ Advertencia

Esta herramienta está diseñada para fines legítimos de investigación de seguridad. Por favor:

• Analice únicamente los dominios que posee o que tiene permiso para probar

• Respete los límites de velocidad y las políticas del servidor DNS

• Úselo de forma responsable y ética

• Tenga en cuenta que algunos servidores DNS pueden limitar la velocidad o bloquear las consultas automatizadas.

• Considere el impacto en la infraestructura de DNS al ejecutar escaneos grandes

Related MCP server: DuckDuckGo MCP Server

Requisitos

• Node.js (v18 o posterior)

• Estibador

• macOS, Linux o Windows con Docker Desktop instalado

Inicio rápido

Instalación mediante herrería

Para instalar DNStwist para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @burtthecoder/mcp-dnstwist --client claude

Instalación manual

1. Instalar Docker:

   • macOS: Instalar Docker Desktop

   • Linux: Siga la guía de instalación de Docker Engine

2. Instalar el servidor globalmente a través de npm:

npm install -g mcp-dnstwist

3. Agregue a su archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "dnstwist": {
      "command": "mcp-dnstwist"
    }
  }
}

Ubicación del archivo de configuración:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Ventanas: %APPDATA%\Claude\claude_desktop_config.json

4. Reiniciar Claude Desktop

Configuración alternativa (de la fuente)

Si prefiere ejecutar desde la fuente o necesita modificar el código:

1. Clonar y construir:

git clone <repository_url>
cd mcp-dnstwist
npm install
npm run build

2. Añade a tu configuración de Claude Desktop:

{
  "mcpServers": {
    "dnstwist": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-dnstwist/build/index.js"]
    }
  }
}

Características

• Fuzzing de dominio : genere permutaciones de dominio utilizando varios algoritmos

• Comprobación de registro : verificar si los dominios permutados están registrados

• Análisis de DNS : comprobar registros A, AAAA, MX y NS

• Presencia web : captura de información de banner HTTP

• Datos WHOIS : recupera fechas de registro e información del registrador

• Detección de phishing : Genera hashes difusos de páginas web

• Configurable : servidores DNS personalizados y procesamiento paralelo

• Múltiples formatos : compatibilidad con formatos de salida json, csv y lista

Herramientas

Herramienta de fuzzing de dominio

• Nombre: fuzz_domain

• Descripción: Generar y analizar permutaciones de dominios para detectar posibles errores tipográficos, phishing y suplantación de marca.

• Parámetros:

  • domain (obligatorio): Nombre de dominio a analizar (p. ej., ejemplo.com)

  • nameservers (opcional, predeterminado: "1.1.1.1"): lista de servidores DNS separados por comas

  • threads (opcional, predeterminado: 50): Número de subprocesos para procesamiento paralelo

  • format (opcional, predeterminado: "json"): Formato de salida (json, csv, lista)

  • registered_only (opcional, predeterminado: verdadero): Mostrar solo dominios registrados

  • mxcheck (opcional, valor predeterminado: verdadero): comprobar si hay registros MX

  • ssdeep (opcional, valor predeterminado: falso): genera hashes difusos de páginas web

  • banners (opcional, valor predeterminado: verdadero): captura información del banner HTTP

Ejemplo:

{
  "domain": "example.com",
  "nameservers": "1.1.1.1,8.8.8.8",
  "threads": 50,
  "format": "json",
  "registered_only": true,
  "mxcheck": true,
  "banners": true
}

Solución de problemas

Problemas con Docker

1. Verifique que Docker esté instalado y en ejecución:

docker --version
docker ps

2. Comprobar los permisos de Docker:

   • Asegúrese de que su usuario tenga permisos para ejecutar comandos de Docker

   • En Linux, agregue su usuario al grupo docker: sudo usermod -aG docker $USER

Problemas comunes

1. Problemas de resolución de DNS:

   • Verificar que los servidores DNS sean accesibles

   • Pruebe servidores DNS alternativos (por ejemplo, 8.8.8.8)

   • Comprobar si hay limitación o bloqueo de velocidad

2. Problemas de rendimiento:

   • Ajustar el número de subprocesos según las capacidades del sistema

   • Considere el ancho de banda y la latencia de la red

   • Supervisar los tiempos de respuesta del servidor DNS

3. Después de solucionar cualquier problema:

   • Guardar el archivo de configuración

   • Reiniciar Claude Desktop

Mensajes de error

• "Docker no está instalado o no se está ejecutando": Instale Docker e inicie el demonio Docker

• "Error al analizar la salida de dnstwist": Verifique si el dominio es válido y el formato es correcto

• "Error al ejecutar dnstwist": Verifique los registros de Docker y asegúrese de que los permisos sean correctos

• "El servidor DNS no responde": Verifique la accesibilidad del servidor DNS y pruebe servidores alternativos

Contribuyendo

1. Bifurcar el repositorio

2. Crear una rama de características ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. Abrir una solicitud de extracción

Licencia

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