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 .

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:

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:

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:

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:

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:

Instalación

Configuración de MCP

Agregue esto a su configuración de Claude Desktop:

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 )