MCP Censys

mcp-censys是一個基於Censys搜索API的MCP服務器，提供即時域名、IP和FQDN偵察功能，支持自然語言查詢轉換為精準的Censys查詢，並內置MCP提示模板以指導Claude分析數據。

安全研究與數據 #域名偵察 #IP查詢 #MCP工具 #即時分析 .Python

評分 : 2.5分

下載量 : 9

更新時間 : 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"
  ]
}