mcp-censys

mcp-censys es un servidor MCP que aprovecha la API de búsqueda de Censys para el reconocimiento de dominios, IP y FQDN en tiempo real, ahora con plantillas de indicaciones de MCP mejoradas.

[!PRECAUCIÓN] Esto es solo una demostración y no está listo para producción. No es un producto con soporte oficial.

Descripción general

mcp-censys convierte las indicaciones en lenguaje natural en consultas Censys específicas, mostrando información de host, DNS, certificado y servicio en tiempo real. Está diseñado para funcionar con Claude Desktop o cualquier otro cliente de Protocolo de Contexto de Modelo (MCP).

Desarrollado sobre el SDK oficial de Python de Censys, este contenedor liviano expone herramientas de reconocimiento precisas a través de funciones compatibles con Claude.

[!NUEVO] Plantillas de indicaciones de MCP

Esta versión presenta las Plantillas de Avisos MCP : conjuntos de instrucciones predefinidos que guían el análisis de datos del dominio por parte de Claude. Estas plantillas proporcionan una guía estructurada sobre cómo organizar y presentar los hallazgos, garantizando resultados consistentes y de alta calidad. Obtenga más información sobre los Avisos MCP .

Related MCP server: ADEO CTI MCP Server

Características

• Consultas conversacionales : acceso en lenguaje natural a la información de Censys

• Búsqueda de dominios e IP : obtenga nombres DNS, ASN, servicios y contexto TLS

• Nuevo descubrimiento de FQDN : encuentre subdominios vistos recientemente a partir de datos de DNS y certificados

• Herramientas compatibles con MCP : úselas directamente desde Claude Desktop

• Plantillas de indicaciones de MCP : ✨ Plantillas de orientación estructuradas integradas que le indican a Claude exactamente cómo analizar y presentar datos del dominio ( obtenga más información sobre las indicaciones de MCP )

• Dockerizado con soporte .env : uso seguro y repetible

• Cliente API ligero : basado en el SDK de Python de Censys

Herramientas

• lookup_domain : obtenga direcciones IP completas, nombres DNS, servicios e información de ASN para un dominio (agrega datos de todos los resultados) con indicaciones MCP integradas que guían a Claude para organizar los hallazgos en secciones significativas

• lookup_domain_detailed : devuelve una muestra de 3 registros de host individuales con servicios, ASN, datos geográficos y TLS, junto con información sobre la cantidad total de registros disponibles y solicitudes MCP estructuradas para un análisis integral de la infraestructura.

• lookup_ip : enriquece una IP con DNS, ASN, información de servicio y metadatos TLS

• new_fqdns - Encuentra FQDN observados recientemente para un dominio (a través de DNS y certificados)

• host_services : enumera los puertos abiertos y los banners de servicio para un dominio o IP determinado

Guía de inicio rápido

1. Búsqueda de dominio ( lookup_domain )

Devuelve información completa agregando todas las IP, nombres DNS, banners de servicio e información de ASN asociados a un dominio específico. Resulta útil para comprender a qué infraestructura se resuelve un dominio.

Ejemplo:

User: What's behind mailchimp.com?

AI: mailchimp.com resolves to multiple IPs operated by The Rocket Science Group (AS2635). The domain exposes ports 80 and 443 with HTTP services, and reverse DNS shows aliases like smtp.mailchimp.com and us1.admin.mailchimp.com. Several servers respond with the banner 'mailchimp-nginx'.

2. Búsqueda detallada de dominio ( lookup_domain_detailed )

Proporciona una muestra de registros de host reales (limitados a 3) que coinciden con una consulta de dominio, además de información sobre cuántos registros en total existen.

Ejemplo:

User: Show me detailed records for mailchimp.com

AI: I found 42 host records for mailchimp.com. Here's a sample of 3:

IP: 205.201.131.98 - Located in Atlanta, GA (The Rocket Science Group)
Services: HTTP/80, HTTPS/443, SMTP/25
OS: Ubuntu 18.04
IP: 205.201.132.24 - Located in Atlanta, GA (The Rocket Science Group)
Services: HTTP/80, HTTPS/443
TLS: TLSv1.2, RSA 2048-bit
IP: 198.2.131.20 - Located in Atlanta, GA (The Rocket Science Group)
Services: SMTP/25, SMTP/587
TLS: TLSv1.2, DH 2048-bit
There are 39 additional records not displayed.

3. Búsqueda de IP ( lookup_ip )

Proporciona contexto completo para una IP, incluidos nombres DNS, ASN, certificados TLS, servicios y datos de ubicación.

Ejemplo:

User: Tell me about 184.29.22.16

AI: 184.29.22.16 is associated with Akamai (AS20940). It has two services exposed: HTTP on port 80 and HTTPS on 443. It's hosted in the United States and uses a TLS certificate issued by Let's Encrypt.

4. Nuevo descubrimiento de FQDN ( new_fqdns )

Encuentre los FQDN observados recientemente para un dominio tanto en los registros DNS como en los registros de transparencia de certificados.

Ejemplo:

User: What new fqdns has microsoft.com had in the last 3 days?
AI: In the last 3 days, 17 FQDNs were observed for microsoft.com, including:

login.microsoft.com (seen in DNS and certs)
api.microsoft.com (seen in certs only)
graph.microsoft.com (seen in DNS only)
teams.microsoft.com (seen in DNS and certs)

5. Servicios de host ( host_services )

Identifica rápidamente qué puertos están abiertos en una IP determinada y qué servicios se están ejecutando.

Ejemplos:

User: What ports are open on example.com?

AI: example.com (93.184.216.34) has the following services:

HTTP on port 80 (last seen 2 hours ago)
HTTPS on port 443 (last seen 2 hours ago)

Instalación

# Clone the repository
git clone https://github.com/yourusername/mcp-censys.git
cd mcp-censys

# Build the Docker image
docker build -t mcp/censys .

# .env should contain:
CENSYS_API_ID=your_censys_api_id
CENSYS_API_SECRET=your_censys_api_secret

Configuración de MCP

Agregue esto a su configuración de Claude Desktop:

"censys": {
  "command": "docker",
  "args": [
    "run",
    "--rm",
    "-i",
    "--env-file", "/Users/yourname/.env.censys",
    "mcp/censys"
  ]
}

Captura de pantalla

mcp-censys en acción a través de Claude Desktop, utilizando las herramientas lookup_domain , lookup_domain_detailed y lookup_ip :

Este ejemplo muestra una solicitud de búsqueda de dominio en mailchimp.com , que devuelve IP, ASN, subdominios, servicios e infraestructura, todo a partir de una consulta en lenguaje natural.

Este ejemplo muestra una solicitud de búsqueda de dominio detallada en mailchimp.com , que devuelve IP, ASN, subdominios, BGP, TLS, información, servicios e infraestructura.

Este ejemplo demuestra una búsqueda de IP en 23.204.1.14 , devolviendo coordenadas, DNS directo e inverso y servicios.

Solución de problemas

No se han devuelto resultados :

• Asegúrese de que el objetivo sea visible públicamente

• Comprueba tu clave API y los límites de velocidad

• Los resultados basados en DNS se basan en observaciones recientes de Censys

Consejos de rendimiento :

• Escanee un solo dominio o IP a la vez para obtener resultados más rápidos

• Utilice lookup_domain o lookup_ip para datos enfocados

Problemas de respuesta de la API :

• Si experimenta errores con el formato de los resultados, asegúrese de estar utilizando la última versión

• Las herramientas manejan la paginación automáticamente: lookup_domain recopila todos los resultados disponibles, mientras que lookup_domain_detailed muestra una muestra limitada.

• Para dominios con muchos resultados, las consultas pueden tardar más en completarse debido a múltiples solicitudes de API

Limitaciones

• new_fqdns no representa los FQDN "vistos por primera vez" verdaderos; filtra por las últimas marcas de tiempo observadas

• Esta herramienta está diseñada para análisis conversacionales de un solo objetivo (no escaneos por lotes)

• lookup_domain_detailed solo muestra 3 registros para mantener las respuestas manejables, incluso cuando hay más disponibles

Licencia

Licencia MIT

Expresiones de gratitud

• SDK de Python de Censys ( https://github.com/censys/censys-python )

• Protocolo de contexto del modelo ( https://modelcontextprotocol.io/ )

• Escritorio de Claude ( https://www.anthropic.com )