servidor shodan-mcp

Este es un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a la API de Shodan. Permite consultar a Shodan programáticamente para obtener información sobre dispositivos, vulnerabilidades y más.

Tabla de contenido

• Introducción

• Instalación

• Configuración

• Uso con Node.js

• Documentación de la API

  • obtener información de IP

  • búsqueda_dns

  • obtener_vulnerabilidades

  • información cve

  • buscar

• Estructura del proyecto

• Contribuyendo

• Licencia

Related MCP server: Shodan-MCP-Server

Introducción

El shodan-mcp-server proporciona una forma sencilla de integrar la inteligencia de Shodan en sus aplicaciones mediante el Protocolo de Contexto de Modelo (MCP). Ofrece varias herramientas que permiten consultar Shodan para obtener diversos tipos de información.

Características

Información del host: obtenga información detallada sobre una dirección IP Búsqueda: consulte la base de datos de Shodan usando su sintaxis de búsqueda Búsqueda de DNS: resuelva nombres de dominio Información de CVE: obtenga detalles sobre vulnerabilidades de CVE específicas

Instalación

1. Clonar el repositorio:

   git clone https://github.com/X3r0K/Shodan-MCP-Server.git
   cd shodan-mcp-server

2. Instalar las dependencias:

   npm install

3. Construir el proyecto:

   npm run build

Configuración

1. Obtén una clave API de Shodan de Shodan .

2. Configure el servidor MCP en su archivo de configuración de MCP (por ejemplo, ~/.config/mcp/settings.json ):

   {
     "mcpServers": {
       "shodan": {
         "command": "node",
         "args": ["/path/to/shodan-mcp-server/build/index.js"],
         "env": {
           "SHODAN_API_KEY": "<your_shodan_api_key>"
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }

   Reemplace <your_shodan_api_key> con su clave API de Shodan real y /path/to/shodan-mcp-server con la ruta real al directorio shodan-mcp-server.

Uso con Node.js

Puede utilizar el servidor MCP con Node.js usando el paquete @modelcontextprotocol/sdk .

1. Instalar el SDK de MCP:

   npm install @modelcontextprotocol/sdk

2. Utilice la función use_mcp_tool para llamar a las herramientas:

   import { use_mcp_tool } from '@modelcontextprotocol/sdk';
   
   async function getIpInfo(ip) {
     const result = await use_mcp_tool('shodan', 'get_ip_info', { ip });
     console.log(result);
   }
   
   getIpInfo('8.8.8.8');

Documentación de la API

obtener información de IP

Obtener información sobre una dirección IP específica.

Aporte:

{
  "ip": "string" // The IP address to query
}

Producción:

Un objeto JSON que contiene información sobre la dirección IP.

búsqueda_dns

Realizar búsquedas de DNS para un dominio determinado.

Aporte:

{
  "hostname": "string" // The hostname to resolve
}

Producción:

Un objeto JSON que contiene la dirección IP resuelta.

obtener_vulnerabilidades

Realizar un seguimiento de las vulnerabilidades asociadas con una dirección IP específica.

Aporte:

{
  "ip": "string" // The IP address to query for vulnerabilities
}

Producción:

Un objeto JSON que contiene una lista de vulnerabilidades asociadas con la dirección IP.

información cve

Recupere información sobre un ID CVE específico.

Aporte:

{
  "cve": "string" // The CVE ID to query
}

Producción:

Un objeto JSON que contiene información sobre el ID de CVE.

buscar

Busque en Shodan dispositivos que coincidan con una consulta.

Aporte:

{
  "query": "string" // The search query
}

Producción:

Un objeto JSON que contiene una lista de dispositivos que coinciden con la consulta.

Estructura del proyecto

shodan-mcp-server/
├── .gitignore
├── package.json
├── README.md
├── tsconfig.json
└── src/
    ├── index.ts
    └── index.mts

Licencia

Instituto Tecnológico de Massachusetts (MIT)