金大哥 - mcp-censys MCP 详情

article

README

🚀 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)

mcp-censys