mcp-greynoise

Servidor MCP para la API de GreyNoise: comprueba si las direcciones IP son ruido de fondo de Internet o ataques potencialmente dirigidos.

Inicio Rápido

npx mcp-greynoise

Eso es todo. Funciona directamente con 10 consultas/día (no se necesita clave API).

Related MCP server: MCP AbuseIPDB Server

¿Qué es GreyNoise?

GreyNoise recopila y analiza el tráfico de escaneo a nivel de Internet. Te indica:

• Noise: ¿Está esta IP escaneando masivamente Internet? (bots, investigadores, rastreadores)

• RIOT: ¿Es esta IP un servicio benigno conocido? (Google, Cloudflare, Microsoft, etc.)

• Clasificación: Malicioso, benigno o desconocido

Por qué esto es importante para la seguridad

Cuando ves tráfico sospechoso en tus registros:

El caso "NO ES NOISE" suele ser el más importante: sugiere que alguien está específicamente interesado en tus sistemas.

Demostración

Ejemplo de salida de check_ip:

IP: 51.91.185.74
Classification: MALICIOUS
Noise: YES - This IP has been observed scanning the internet
RIOT: NO - Not a known benign service IP
Last Seen: 2024-01-15
Details: https://viz.greynoise.io/ip/51.91.185.74

--- Interpretation ---
🚨 This IP is actively scanning the internet and classified as MALICIOUS. 
   Likely a scanner, botnet, or threat actor.

Instalación

npm (recomendado)

npm install -g mcp-greynoise

npx (sin instalación)

npx mcp-greynoise

Desde el código fuente

git clone https://github.com/nickjlucker/mcp-greynoise.git
cd mcp-greynoise
npm install
npm run build
node build/index.js

Configuración

Claude Desktop

Añade a tu claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "greynoise": {
      "command": "npx",
      "args": ["mcp-greynoise"],
      "env": {
        "GREYNOISE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Variables de Entorno

Obtén una clave API gratuita en viz.greynoise.io/signup.

⚠️ Nunca subas claves API. Consulta .env.example para la configuración recomendada.

Herramientas

check_ip

Comprueba una sola dirección IP contra GreyNoise.

Entrada:

• ip (cadena): Dirección IPv4 a comprobar

check_ips

Comprueba múltiples direcciones IP en una sola llamada (máx. 10).

Entrada:

• ips (cadena[]): Array de direcciones IPv4

Ejemplo de salida:

=== Results ===
8.8.8.8: RIOT (benign service) [Google]
51.91.185.74: NOISE - MALICIOUS
192.168.1.1: NOT NOISE (potentially targeted)

--- Legend ---
RIOT: Known benign service (CDN, DNS, etc.)
NOISE: IP is mass-scanning the internet
NOT NOISE: IP is NOT mass-scanning (traffic may be targeted)

Recursos

greynoise://status

Devuelve información sobre el estado de la API y los límites de tasa.

Límites de Tasa

Los límites de tasa se comparten entre las llamadas a la API y el Visualizador de GreyNoise.

Seguridad

Este servidor:

• Solo lee de la API de GreyNoise (sin escaneo, sin explotación)

• No almacena ningún dato más allá de la solicitud actual

• No transmite tu clave API a ningún lugar excepto a GreyNoise

• Realiza solo enriquecimiento de reputación/telemetría

Tu clave API se pasa a través de una variable de entorno y nunca se registra.

Casos de Uso

• Triaje en SOC: Determina rápidamente si las IPs de las alertas son ruido de fondo o están dirigidas

• Respuesta a Incidentes: Identifica si las IPs de los atacantes son escáneres masivos o amenazas enfocadas

• Búsqueda de Amenazas: Encuentra IPs en tus registros que no sean escáneres masivos (potencialmente dirigidas)

• Análisis de Registros: Reduce los falsos positivos filtrando escáneres conocidos

Desarrollo

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run built version
npm start

Licencia

MIT

Enlaces

• GreyNoise

• Documentación de la API de GreyNoise

• Protocolo de Contexto de Modelo

• Registro MCP