Shodan MCP Server

Servidor MCP de Shodan

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a la funcionalidad de la API de Shodan, lo que permite a los asistentes de IA consultar información sobre dispositivos y servicios conectados a Internet.

Características

• Información del host : obtenga información detallada sobre direcciones IP específicas
• Capacidades de búsqueda : Busque dispositivos y servicios en la base de datos de Shodan
• Escaneo de red : escanee rangos de red (notación CIDR) para dispositivos
• Información del certificado SSL : Obtenga detalles del certificado SSL para dominios
• Búsqueda de dispositivos IoT : encuentre tipos específicos de dispositivos IoT

Instalación

1. Clonar el repositorio:
   git clone https://github.com/Cyreslab-AI/shodan-mcp-server.git cd shodan-mcp-server
2. Instalar dependencias:
   npm install
3. Construir el servidor:
   npm run build
4. Configura tu clave API de Shodan:
   export SHODAN_API_KEY="your-api-key-here"
5. Iniciar el servidor:
   npm start

Integración MCP

Este servidor se puede integrar con Claude u otros asistentes de IA compatibles con MCP. Para añadirlo a Claude Desktop o Claude.app:

1. Agregue el servidor a su configuración de MCP:
   { "mcpServers": { "shodan": { "command": "node", "args": ["/path/to/shodan-mcp-server/build/index.js"], "env": { "SHODAN_API_KEY": "your-api-key-here" } } } }
2. Reinicie Claude para cargar el nuevo servidor MCP.

Herramientas disponibles

obtener_información_del_host

Obtenga información detallada sobre una dirección IP específica.

Parámetros:

• ip (obligatorio): dirección IP a buscar
• max_items (opcional): número máximo de elementos a incluir en las matrices (valor predeterminado: 5)
• fields (opcional): Lista de campos a incluir en los resultados (por ejemplo, ['ip_str', 'ports', 'location.country_name'])

búsqueda_shodan

Busque en la base de datos de Shodan dispositivos y servicios.

Parámetros:

• query (obligatoria): consulta de búsqueda de Shodan (por ejemplo, 'apache country:US')
• page (opcional): Número de página para la paginación de resultados (predeterminado: 1)
• facets (opcional): Lista de facetas para incluir en los resultados de búsqueda (por ejemplo, ['país', 'org'])
• max_items (opcional): número máximo de elementos a incluir en las matrices (valor predeterminado: 5)
• fields (opcional): Lista de campos a incluir en los resultados (por ejemplo, ['ip_str', 'ports', 'location.country_name'])
• summarize (opcional): si se debe devolver un resumen de los resultados en lugar de los datos completos (valor predeterminado: falso)

rango de red de escaneo

Escanee un rango de red (notación CIDR) en busca de dispositivos.

Parámetros:

• cidr (obligatorio): rango de red en notación CIDR (por ejemplo, 192.168.1.0/24)
• max_items (opcional): Número máximo de elementos a incluir en los resultados (predeterminado: 5)
• fields (opcional): Lista de campos a incluir en los resultados (por ejemplo, ['ip_str', 'ports', 'location.country_name'])

obtener_información_ssl

Obtener información del certificado SSL para un dominio.

Parámetros:

• domain (obligatorio): nombre de dominio para buscar certificados SSL (por ejemplo, ejemplo.com)

búsqueda_de_dispositivos_iot

Busque tipos específicos de dispositivos IoT.

Parámetros:

• device_type (obligatorio): tipo de dispositivo IoT a buscar (por ejemplo, 'cámara web', 'enrutador', 'televisión inteligente')
• country (opcional): código de país opcional para limitar la búsqueda (por ejemplo, 'EE. UU.', 'DE')
• max_items (opcional): Número máximo de elementos a incluir en los resultados (predeterminado: 5)

Recursos disponibles

• shodan://host/{ip} : Información sobre una dirección IP específica

Limitaciones de la API

Algunos puntos finales de la API de Shodan requieren una suscripción de pago. Las siguientes funciones solo están disponibles con una clave de API de Shodan de pago:

• Funcionalidad de búsqueda
• Escaneo de red
• Búsqueda de certificado SSL
• Búsqueda de dispositivos IoT

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Desarrollado por

Cyreslab.ai