mcp-dnstwist

MIT License
23
9
  • Apple
  • Linux

local-only server

The server can only run on the client’s local machine because it depends on local resources.

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 :

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

Instalación manual

  1. Instalar Docker:
  2. Instalar el servidor globalmente a través de npm:
npm install -g mcp-dnstwist
  1. 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
  1. 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
  1. 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
  1. 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.

-
security - not tested
A
license - permissive license
-
quality - not tested

Un servidor de Protocolo de Contexto Modelo (MCP) para dnstwist , una poderosa herramienta de fuzzing de DNS que ayuda a detectar typosquatting, phishing y espionaje corporativo.

  1. ⚠️ Warning
    1. Requirements
      1. Quick Start
        1. Installing via Smithery
        2. Installing Manually
      2. Alternative Setup (From Source)
        1. Features
          1. Tools
            1. Domain Fuzzing Tool
          2. Troubleshooting
            1. Docker Issues
            2. Common Issues
          3. Error Messages
            1. Contributing
              1. License
                ID: it7izu3ufb