MCP Censys

mcp-censys是一个基于Censys搜索API的MCP服务器，提供实时域名、IP和FQDN侦察功能，支持自然语言查询转换为精准的Censys查询，并内置MCP提示模板以指导Claude分析数据。

安全研究与数据 #域名侦察 #IP查询 #MCP工具 #实时分析 .Python

评分 : 2.5分

下载量 : 11

更新时间 : 2025-04-29

What is mcp-censys?

mcp-censys is a conversational interface that lets you query Censys' internet-wide scan data using plain English. It translates your questions into technical queries and presents the results in an easy-to-understand format. The service provides insights about websites, servers, and network infrastructure without requiring technical expertise.

How to use mcp-censys?

Simply ask questions about domains or IP addresses in natural language. The system will automatically query Censys data and organize the results into clear categories like services, locations, and security information. No need to learn complex search syntax.

When to use mcp-censys?

Ideal for: 1) Investigating website infrastructure 2) Discovering connected services 3) Security research 4) Finding new subdomains 5) Understanding server configurations

Key Features

Natural Language QueriesAsk questions in plain English without learning complex search syntax

Comprehensive Domain LookupGet complete information about all IPs, services, and infrastructure associated with a domain

MCP Prompt TemplatesPredefined analysis templates that guide how results are organized and presented for consistency

New Subdomain DiscoveryFind recently observed subdomains through DNS and certificate data

IP Address AnalysisGet detailed information about any IP address including services, location, and ownership

Strengths & Limitations

Strengths

No technical expertise required - ask questions in natural language

Comprehensive data aggregation from multiple sources

Structured presentation of complex technical information

Built-in analysis templates ensure consistent, high-quality results

Lightweight and easy to deploy with Docker

Limitations

Only shows sample records for domains with many results

Subdomain discovery doesn't show true 'first seen' dates

Designed for single-target analysis, not batch processing

Dependent on Censys scan data (may not have real-time updates)

Requires API keys for full functionality

Getting Started

Set up your environment

Install Docker and create a configuration file with your Censys API credentials

Build the Docker image

Create the service container from the provided Dockerfile

Configure your MCP client

Add the service configuration to your Claude Desktop or other MCP client

Start asking questions

Use natural language queries to investigate domains and IP addresses

Example Use Cases

Investigating a Website's InfrastructureUnderstand what servers and services power a particular website

Security AssessmentCheck what ports and services are exposed on a company's network

Subdomain DiscoveryFind new or recently observed subdomains for monitoring purposes

Frequently Asked Questions

Why am I not getting any results?

How current is the data?

Can I scan multiple targets at once?

What are MCP Prompt Templates?

Additional Resources

Censys Python SDK

Official Python library for Censys API

Model Context Protocol

Documentation about MCP architecture

Censys Search API

Information about the underlying API service

🚀 mcp-censys 中文文档

mcp-censys 是一个 MCP 服务器，可连接至 Censys 搜索 API。它能助力您实时获取域名、IP 和 FQDN 的相关信息，还提供了增强的 MCP 提示模板。

🚀 快速开始

mcp-censys 是一个 MCP 服务器，用于连接到 Censys 搜索 API。它可以帮助您实时获取域名、IP 和 FQDN 的信息，并提供增强的 MCP 提示模板。

⚠️ 重要提示

此工具仅用于演示用途，请勿在生产环境中使用。

📦 安装指南

# 克隆仓库
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"
  ]
}