mcp审查
mcp-censys是一个mcp服务器，它利用censys搜索API进行实时域、IP和FQDN侦察，现在具有增强的 MCP提示模板.
\[！小心\] 这仅作为演示，尚未准备好投入生产。它不是官方支持的产品。
概述
mcp-censys将自然语言提示转化为有针对性的censys查询，实时显示主机、DNS、证书和服务信息。它旨在与Claude Desktop或任何其他模型上下文协议（MCP）客户端配合使用。
这个轻量级容器基于Censys官方Python SDK构建，通过Claude友好的函数提供精确的侦察工具。
新 MCP提示模板 此版本介绍 MCP提示模板 -指导Claude分析域数据的预定义指令集。这些模板为如何组织和呈现调查结果提供了结构化的指导，确保了一致的高质量产出。 了解有关MCP提示的更多信息.
特性
- 会话查询：Censys intel的自然语言访问
- 域名和IP查找：获取DNS名称、ASN、服务和TLS上下文
- 新FQDN发现：从DNS和证书数据中查找最近看到的子域
- MCP兼容工具：直接从克劳德桌面使用
- MCP提示模板: ✨ 内置结构化指导模板，指导Claude准确分析和呈现领域数据(了解有关MCP提示的更多信息)
- 使用.env支持进行Docker化：安全、可重复使用
- 轻量级API客户端：基于Censys Python SDK
工具
- lookup_domain -通过以下方式获取域的全面IP、DNS名称、服务和ASN信息（聚合所有结果中的数据） 内置MCP提示 指导克劳德将研究结果组织成有意义的部分
- lookup_domain_detailed -返回包含服务、ASN、地理和TLS数据的3个单独主机记录的示例，以及有关总可用记录和 结构化MCP提示 进行全面的基础设施分析
- lookup_ip -使用DNS、ASN、服务信息和TLS元数据丰富IP
- new_fqdns -查找域的最近观察到的FQDN（通过DNS和证书）
- 主机服务 -列出给定域或IP的开放端口和服务横幅
快速入门指南
1.域名查询(lookup_domain)
通过聚合与特定域关联的所有IP、DNS名称、服务横幅和ASN信息来返回完整信息。有助于了解域解析为什么基础架构。
例子：
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.详细的域名查询(lookup_domain_detailed)
提供与域查询匹配的实际主机记录示例（限制为3条），以及有关存在多少条记录的信息。
例子：
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.IP查找(lookup_ip)
提供IP的完整上下文，包括DNS名称、ASN、TLS证书、服务和位置数据。
例子：
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.新FQDN发现(new_fqdns)
从DNS记录和证书透明度日志中查找域的最近观察到的FQDN。
例子：
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.主机服务(host_services)
快速识别给定IP上打开的端口以及正在运行的服务。
示例：
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)安装
# 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_secretMCP配置
将此添加到您的Claude Desktop配置中：
"censys": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--env-file", "/Users/yourname/.env.censys",
"mcp/censys"
]
}截图
mcp通过Claude Desktop使用 lookup_domain, lookup_domain_detailed 和 lookup_ip 工具：
此示例显示了上的域查找请求 mailchimp.com，返回IP、ASN、子域、服务和基础设施——所有这些都来自自然语言查询。此示例显示了上的详细域查找请求 mailchimp.com，返回IP、ASN、子域、BGP、TLS、信息、服务和基础设施。此示例演示了IP查找 23.204.1.14，返回坐标，正向和反向DNS和服务。故障排除
未返回任何结果:
- 确保目标是公开可见的
- 检查您的API密钥和费率限制
- 基于DNS的结果依赖于Censys最近的观察结果
性能提示:
- 一次扫描单个域或IP以获得更快的结果
- 使用lookup_domain或lookup_ip获取重点数据
API响应问题:
- 如果您在结果格式设置方面遇到错误，请确保您使用的是最新版本
- 这些工具会自动处理分页——lookup_domain会收集所有可用的结果，而lookup_ddomain_detailed则显示了一个有限的示例
- 对于有许多结果的域，由于多个API请求，查询可能需要更长的时间才能完成
局限性
- new_fqdns不代表真正的“首次看到”FQDN；它根据最后观察到的时间戳进行过滤
- 此工具用于对话式单目标分析（不是批量扫描）
- lookup_domain_detailed仅显示3条记录，以保持响应的可管理性，即使有更多记录可用
许可证
MIT许可证
致谢
- Censys Python SDK(https://github.com/censys/censys-python)
- 模型上下文协议(https://modelcontextprotocol.io/)
- 克劳德桌面(https://www.anthropic.com)