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: IR Toolshed 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:
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 )