Sec Censys MCP

Censys MCP服务器

  

模型上下文协议（MCP）服务器 Censys搜索API v2，使AI助手能够搜索互联网范围的扫描数据、SSL/TLS证书和主机信息。

概述

Censys是一个搜索引擎，允许安全研究人员发现、监控和分析互联网上暴露的设备和服务。此MCP服务器提供对Censys Search API功能的全面访问，包括：

• 主机发现 -搜索数十亿个IP地址及其服务
• 证书智能 -查找和分析SSL/TLS证书
• 历史分析 -跟踪主机随时间的变化
• 汇总统计 -生成报告和统计数据

特性

主机搜索工具

证书工具

组织工具

安装

git clone https://github.com/schwarztim/sec-censys-mcp.git
cd sec-censys-mcp
npm install
npm run build

配置

环境变量

从以下位置获取您的API证书：https://search.censys.io/account/api

Claude桌面配置

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "censys": {
      "command": "node",
      "args": ["/path/to/sec-censys-mcp/dist/index.js"],
      "env": {
        "CENSYS_API_ID": "your-api-id",
        "CENSYS_API_SECRET": "your-api-secret"
      }
    }
  }
}

使用示例

在美国搜索具有开放SSH端口的主机

{
  "tool": "censys_search_hosts",
  "arguments": {
    "query": "services.port: 22 AND location.country: US",
    "per_page": 10
  }
}

获取有关IP的详细信息

{
  "tool": "censys_view_host",
  "arguments": {
    "ip": "8.8.8.8"
  }
}

搜索通配符证书

{
  "tool": "censys_search_certs",
  "arguments": {
    "query": "names: *.google.com"
  }
}

查找运行HTTP服务器的顶级国家

{
  "tool": "censys_aggregate_hosts",
  "arguments": {
    "query": "services.service_name: HTTP",
    "field": "location.country",
    "num_buckets": 10
  }
}

跟踪主机随时间的变化

{
  "tool": "censys_host_events",
  "arguments": {
    "ip": "1.2.3.4",
    "start_time": "2024-01-01T00:00:00Z",
    "end_time": "2024-12-31T23:59:59Z"
  }
}

Censys搜索语言

Censys使用强大的查询语言进行搜索。常见模式：

主机查询

证书查询

组合查询

services.port: 443 AND location.country: US AND NOT autonomous_system.name: Amazon

API费率限制

费率限制取决于您的Censys帐户级别：

请访问以下网址查看您的使用情况：https://search.censys.io/account

安全考虑

• 使用环境变量安全地存储API凭据
• 从不将凭据提交到版本控制
• 使用适当的价格限制以避免API滥用
• 发现漏洞时遵循负责任的披露做法

发展

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode
npm run dev

许可证

MIT许可证-请参阅 许可证 了解详情。

链接

• Censys搜索
• Censys API文档
• 模型上下文协议
• MCP TypeScript SDK