Repolode
w0h1v

w0h1v/mcp-shodan

Servidor MCP que da a agentes de IA acceso a la API de Shodan y a CVEDB para buscar dispositivos en Internet y obtener inteligencia sobre hosts, DNS y CVE.

Alternativa open source a:Shodan

Estrellas
187
Forks
31
Issues abiertos
3
Último commit
hace 3 días

¿Qué es?

mcp-shodan es un servidor MCP que conecta agentes de IA como Claude, Codex y Gemini CLI con la API de Shodan y Shodan CVEDB. Al proporcionar una IP, un nombre de host, una consulta de búsqueda, un producto o un CVE, el agente recibe puertos abiertos y banners, detalles de certificados TLS, registros DNS y la gravedad de las vulnerabilidades, junto con datos de EPSS y el estado en KEV.

El servidor ofrece once herramientas de solo lectura en tres grupos: consultas de red (información de hosts, búsqueda de dispositivos, recuentos, subdominios y resolución DNS por lotes), inteligencia sobre vulnerabilidades de CVEDB (detalles de CVE, consultas de CPE y CVE por producto) y herramientas auxiliares para listar filtros de búsqueda y consultar los créditos de API restantes. Las herramientas gratuitas están marcadas como tales y las llamadas a CVEDB no requieren una clave de API.

Funciona mediante stdio para clientes de escritorio o como servicio de streaming HTTP, y requiere Node.js 20 o posterior y una clave de API de Shodan propia. Las entradas se validan con esquemas de zod antes de enviar las solicitudes, y la clave solo se envía a api.shodan.io.

Funciones clave

  • 01Reconocimiento de hosts en direcciones IPv4 e IPv6, incluidos puertos, productos, CVE y detalles de TLS.
  • 02Búsqueda de dispositivos con la sintaxis de consultas de Shodan, paginación y desglose por facetas.
  • 03Consultas gratuitas que solo cuentan resultados para estimar el tamaño de una búsqueda antes de gastar créditos.
  • 04Consultas de CVE y CPE con datos de CVSS, EPSS y KEV mediante CVEDB.
  • 05Consultas DNS directas e inversas por lotes, además de enumeración de subdominios.
  • 06Transporte por stdio o streaming HTTP, con compatibilidad con imágenes de Docker.

Casos de uso

  • Preguntar a un agente de IA qué servicios están expuestos en una IP durante una revisión de seguridad.
  • Comprobar si un CVE aparece en el catálogo KEV y cuál es la probabilidad de que se explote según la puntuación EPSS.
  • Estimar el tamaño de una búsqueda en todo Internet mediante consultas de recuento gratuitas antes de ejecutar búsquedas de pago.
  • Enumerar subdominios y resolver registros DNS para inventariar la superficie de ataque externa.

Inicio rápido

  1. 1

    Obtén una clave de API de Shodan desde la página de tu cuenta

  2. 2

    Añade el servidor a Claude Code

    claude mcp add --transport stdio --env SHODAN_API_KEY=your-key shodan -- npx -y @burtthecoder/mcp-shodan

Antes de usarlo

  • Necesitas una clave de API de Shodan propia, de pago o con membresía. Para usar filtros de búsqueda, también necesitas una membresía o un plan de pago.
  • El transporte HTTP no tiene autenticación, por lo que debe mantenerse en localhost o detrás de un proxy con autenticación.

En colecciones

Temas

Preguntas frecuentes

¿Qué es mcp-shodan?
Servidor MCP que da a agentes de IA acceso a la API de Shodan y a CVEDB para buscar dispositivos en Internet y obtener inteligencia sobre hosts, DNS y CVE. mcp-shodan es un servidor MCP que conecta agentes de IA como Claude, Codex y Gemini CLI con la API de Shodan y Shodan CVEDB. Al proporcionar una IP, un nombre de host, una consulta de búsqueda, un producto o un CVE, el agente recibe puertos abiertos y banners, detalles de certificados TLS, registros DNS y la gravedad de las vulnerabilidades, junto con datos de EPSS y el estado en KEV.
¿mcp-shodan es gratuito? ¿Qué licencia tiene?
mcp-shodan es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mcp-shodan sigue mantenido?
Mantenimiento activo. El último commit de mcp-shodan fue el 4 nov 2026.
¿Para qué puedo usar mcp-shodan?
Preguntar a un agente de IA qué servicios están expuestos en una IP durante una revisión de seguridad. Comprobar si un CVE aparece en el catálogo KEV y cuál es la probabilidad de que se explote según la puntuación EPSS. Estimar el tamaño de una búsqueda en todo Internet mediante consultas de recuento gratuitas antes de ejecutar búsquedas de pago. Enumerar subdominios y resolver registros DNS para inventariar la superficie de ataque externa.
¿Cómo se instala mcp-shodan?
Obtén una clave de API de Shodan desde la página de tu cuenta Añade el servidor a Claude Code: claude mcp add --transport stdio --env SHODAN_API_KEY=your-key shodan -- npx -y @burtthecoder/mcp-shodan
¿Dónde consigo mcp-shodan?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/w0h1v/mcp-shodan

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados

Herramienta de inteligencia de fuentes abiertas, todo en uno, que realiza análisis bajo demanda de cualquier sitio web: DNS, SSL, encabezados, información del servidor y configuración de seguridad.

35,4 mil+87 esta semana2,9 milTypeScriptMITActualizado anteayer