MCP Recon

MCP Recon

一款全面的 Model Context Protocol（MCP）服务，用于 Web 安全侦察与分析。该工具包通过 Python 原生实现，为网络安全专业人员提供必要的侦察功能，并遵循标准的网络安全侦察方法。

🚀 功能

📊 1. 信息收集（被动侦察）

• WHOIS 信息：域名注册和所有权详情
• 域名历史：信誉和历史数据分析

🔍 2. DNS 分析（基础设施发现）

• DNS 记录查询：全面枚举 DNS（A、AAAA、MX、NS、TXT、SPF、DMARC）
• 反向 DNS 查询：将 IP 解析为主机名
• 被动子域名枚举：通过 crt.sh 发现证书透明度日志（隐蔽）
• 主动子域名枚举：使用 subdomains.txt 中的字典进行 DNS 暴力枚举

🌐 3. 网络侦察（主动扫描）

• IP 信息：地理位置、ISP 和网络详情
• 存活检测：通过 HTTP/HTTPS 测试连接并分析响应
• 端口扫描：集成高级 Nmap，支持多种扫描模式

🔒 4. Web 应用分析（应用层）

• TLS 证书分析：检查并验证 SSL/TLS 证书
• HTTP 标头分析：评估安全标头并检测信息泄露
• 技术检测：识别 Web 框架和技术指纹
• URL 提取：爬取网页并发现链接

🛠 安装

先决条件

• Python 3.10+
• UV 包管理器（由脚本自动安装）
• Nmap（由脚本自动安装）

快速安装

Windows（PowerShell）

.\install.ps1

Linux/macOS

chmod +x install.sh
./install.sh

Claude Desktop 配置

将此配置添加到 Claude Desktop 设置中，以连接 MCP Web Reconnaissance Server：

Windows 配置

{
  "mcpServers": {
    "recon": {
      "command": "C:\\Users\\YOUR_USERNAME\\.local\\bin\\uv.exe",
      "args": [
        "--directory",
        "C:\\Users\\YOUR_USERNAME\\path\\to\\MCP_Recon",
        "run",
        "python",
        "main.py"
      ]
    }
  }
}

Linux/macOS 配置

{
  "mcpServers": {
    "recon": {
      "command": "/home/YOUR_USERNAME/.local/bin/uv",
      "args": [
        "--directory",
        "/home/YOUR_USERNAME/path/to/MCP_Recon",
        "run",
        "python",
        "main.py"
      ]
    }
  }
}

替换以下占位符：

• 将 YOUR_USERNAME 替换为你的实际用户名
• 将 path/to/MCP_Recon 替换为你克隆的仓库的实际路径

配置文件位置：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

🚀 用法

可用工具（遵循侦察方法）

1. 信息收集（被动侦察）

• whois_info - 获取 WHOIS 信息
• domain_history - 检查域名信誉和历史记录

2. DNS 分析（基础设施发现）

• dns_records - 获取域名的所有 DNS 记录
• reverse_dns - 执行反向 DNS 查询
• subdomain_enum_passive - 通过证书透明度（crt.sh）被动发现子域名
• subdomain_enum_active - 使用 DNS 暴力枚举主动枚举子域名

3. 网络侦察（主动扫描）

• ip_information - 获取全面的 IP 信息
• check_alive - 检查主机是否通过 HTTP/HTTPS 响应
• port_scan - 使用 Nmap 进行高级端口扫描

4. Web 应用分析（应用层）

• tls_certificate - 分析 TLS 证书
• http_headers - 分析 HTTP 安全标头
• detect_technologies - 检测 Web 技术
• extract_urls - 从网页中提取 URL

🔧 配置

自定义 User-Agent

对于要求进行特定身份标识的漏洞赏金计划，基于 HTTP 的工具支持可选的 user_agent 参数。提供该参数后，它会替换所有发往目标的 HTTP 请求中的默认 User-Agent。

示例：

# Default User-Agent
http_headers("https://example.com")

# Custom User-Agent for bug bounty programs
http_headers("https://example.com", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36 bug-bounty")

支持自定义 User-Agent 的工具：

• http_headers - HTTP 标头分析
• detect_technologies - 技术指纹识别
• extract_urls - URL 提取／爬取
• check_alive - 主机连通性检查

🔧 字典

子域名字典自定义

你可以通过两种方式自定义子域名枚举：

1. 编辑字典文件

修改项目根目录中的 subdomains.txt 文件，以添加／移除子域名：

www
api
admin
test
dev
staging
# Add your custom subdomains here

2. 在 Claude Desktop 聊天中提供自定义字典

端口扫描选项

端口扫描器支持针对不同场景优化的多种模式：

• "common"：常见服务（21,22,23,25,53,80,443 等）
• "top100"：最常见的前 100 个端口（推荐用于初步侦察）
• "top1000"：前 1000 个端口（全面发现）
• "80,443,8080"：指定端口（针对性扫描）
• "1-1000"：端口范围（内部网络扫描）

🏗 架构

项目结构

mcp-recon/
├── main.py                 # MCP server entry point with organized tool categories
├── subdomains.txt          # Default subdomain wordlist (customizable)
├── tools/
│   ├── info_tools.py       # Information gathering utilities (WHOIS, domain history)
│   ├── dns_tools.py        # DNS and domain reconnaissance
│   ├── network_tools.py    # Network scanning and analysis
│   └── web_tools.py        # Web application analysis
├── install.ps1            # Windows installation script
├── install.sh             # Linux/macOS installation script
├── pyproject.toml          # Python project configuration
└── README.md              # This documentation

📝 许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

⚠️ 免责声明

此工具仅用于合法的安全研究、渗透测试和漏洞赏金活动。用户有责任确保在扫描或测试任何网络、系统或应用程序之前获得适当授权。作者不对滥用此工具的行为负责。

请始终遵循负责任的漏洞披露实践，并遵守漏洞赏金计划的范围限制。