mcp-dnstwist

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

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 :

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:

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

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:

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

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:

Solución de problemas

Problemas con Docker

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

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.