🚀 mcp-censys 中文文档
mcp-censys 是一个 MCP 服务器，可连接到 Censys 搜索 API。借助它，您能实时获取域名、IP 和 FQDN 的信息，还能使用增强的 MCP 提示模板。
⚠️ 重要提示
此工具仅用于演示用途，请勿在生产环境中使用。
🚀 快速开始
mcp-censys 能为您提供域名、IP 和 FQDN 的实时信息。下面将为您介绍如何安装和配置该工具。
📦 安装指南
# 克隆仓库
git clone https://github.com/yourusername/mcp-censys.git
cd mcp-censys
# 构建 Docker 镜像
docker build -t mcp/censys .
# .env 文件应包含以下内容：
CENSYS_API_ID=your_censys_api_id
CENSYS_API_SECRET=your_censys_api_secret
📚 详细文档
MCP 配置
将以下内容添加到您的 Claude Desktop 配置中：
"censys": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--env-file", "/Users/yourname/.env.censys",
"mcp/censys"
]
}
截图
以下是 mcp-censys 在 Claude Desktop 中的实际操作示例：
- 域名/FQDN 查询：显示域名的 IP、ASN、子域名和服务等信息。
- 详细域名查询：返回更详细的域名信息，包括 IP、ASN、BGP 和 TLS 等信息。
- IP 查询：显示 IP 的坐标、正向和反向 DNS 以及服务信息。
故障排除
无结果返回
- 确保目标是公开可见的。
- 检查您的 API 密钥和速率限制。
- DNS 结果依赖于 Censys 的最近观测数据。
性能提示
- 单次查询一个域名或 IP 可以提高速度。
- 使用
lookup_domain或lookup_ip获取更聚焦的数据。
API 响应问题
- 如果遇到结果格式错误，请确保使用最新版本。
- 工具会自动处理分页，
lookup_domain会收集所有可用结果，而lookup_domain_detailed只显示部分记录。
局限性
new_fqdns并不表示真正的“首次出现”的 FQDN，而是基于最后观测时间进行过滤。- 此工具适用于单目标分析，不适合批量扫描。
lookup_domain_detailed仅显示 3 条记录以保持响应大小。
📄 许可证
本项目采用 MIT 许可证。
🙏 致谢
感谢以下项目的贡献：
- Censys Python SDK (https://github.com/censys/censys-python)
- Model Context Protocol (https://modelcontextprotocol.io/)
- Claude Desktop (https://www.anthropic.com)