shodan-mcp

Servidor MCP de reconocimiento pasivo impulsado por Shodan. Restringido por alcance según tus instantáneas de HackerOne: el mismo filtro que nuclei-mcp.

Solo pasivo — Las consultas de Shodan nunca envían un paquete a tu objetivo. Todos los datos provienen del índice de escaneo de internet preexistente de Shodan.

Arquitectura

Claude/copilot (AI agent)
    │
    │  MCP (stdio)
    ▼
shodan-mcp container
    ├── reads scope ──► /data/snapshots/*.json  ◄─── h1-scope-watcher
    └── queries     ──► api.shodan.io  (passive, no target contact)

Related MCP server: Shodan MCP Server

Filtro de alcance

Cada herramienta ejecuta el mismo filtro que nuclei-mcp:

1. Cargar todos los *.json desde /data/snapshots

2. Coincidencia exacta → comodín → coincidencia difusa de palabras clave

3. Verificar eligible_for_bounty Y eligible_for_submission

4. Bloquear si alguno es falso — sin anulación

H1-Scope-Watcher

Inicio rápido

1. Compilación

cd shodan-mcp
docker build -t shodan-mcp .

2. Añadir a la configuración MCP de Claude/Copilot

{
  "mcpServers": {
    "h1-scope-watcher": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "D:/projects/H1-Scope-Watcher/snapshots:/data/snapshots",
        "-e", "SNAPSHOTS_DIR=/data/snapshots",
        "mcp/h1-scope"
      ]
    },
    "shodan-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "D:/projects/H1-Scope-Watcher/snapshots:/data/snapshots",
        "-e", "SNAPSHOTS_DIR=/data/snapshots",
        "-e", "SHODAN_API_KEY=YOUR_KEY_HERE",
        "shodan-mcp"
      ]
    }
  }
}

Reemplaza YOUR_KEY_HERE con tu clave de https://account.shodan.io

Herramientas MCP

shodan_host

Resolver objetivo → IP(s) → informe completo del host en Shodan.

Lo que obtienes por IP:

• Puertos abiertos + protocolo de transporte

• Huella digital de servicio / producto / versión

• Identificadores CPE

• Lista de CVE con puntuaciones CVSS y resúmenes

• ASN, ISP, organización, geolocalización, SO

• Etiquetas de Shodan (ej. cloud, self-signed, vpn)

Ejemplos de prompts:

• "Ejecuta shodan en dummy-target"

• "¿Qué puertos expone api.tile.com en Shodan?"

• "Comprueba shodan para production.tile-api.com con banners"

shodan_search

Busca en el índice hostname: de Shodan — encuentra registros en TODAS las IPs que hayan servido alguna vez el nombre de host, incluyendo infraestructura antigua/oculta.

Ejemplos de prompts:

• "Busca en Shodan dummy-target — muéstrame 10 resultados"

• "¿Alguna infraestructura olvidada para tile.com en Shodan?"

shodan_dns

Extrae los registros de DNS pasivo de Shodan — todos los subdominios, A/CNAME/MX/TXT que Shodan haya observado alguna vez para un dominio raíz.

Ejemplos de prompts:

• "¿Qué subdominios conoce Shodan para dummy-target?"

• "Muéstrame los registros DNS de Shodan para tile.com"

check_scope

Vista previa del filtro de alcance sin realizar ninguna llamada a la API.

list_programs

Enumera todos los activos de alcance de H1 agrupados por elegibilidad de recompensa.

Notas sobre el plan de Shodan

shodan_dns requiere un plan de Shodan de pago. El servidor valida tu clave y plan al iniciarse y registra el resultado.

Ejemplo de flujo de trabajo encadenado

You: "Full passive recon on dummy-target"

Claude/Copilot:
  1. check_scope("dummy-target")
    → ✅ api.dummy-target.com, api-cloudfront.dummy-target.com

  2. shodan_dns("dummy-target")
    → 14 subdomains discovered passively

  3. shodan_host("api.dummy-target.com")
    → Port 443 (nginx 1.18), Port 8443 (unknown)
    → CVE-2021-23017 CVSS 7.7 (nginx)

  4. shodan_search("dummy-target", max_results=10)
    → 3 IPs, one on non-standard port 9200 (Elasticsearch!)

  5. nuclei_scan("api.dummy-target.com")
    → Confirms Elasticsearch exposure

Cero paquetes enviados al objetivo ficticio hasta el paso 5.