网络安全侦查工具

MCP Recon是一个全面的网络安全侦查工具,提供信息收集、DNS分析、网络侦查和Web应用分析功能,适用于安全研究和渗透测试。

  • by sundayz-hunter
  • Python
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 sundayz-hunter/MCP_Recon

使用说明

MCP侦察

用于网络安全侦察和分析的综合模型上下文协议(MCP)服务器。该工具包遵循标准的网络安全侦察方法,通过Python原生实现为网络安全专业人员提供基本的侦察能力。

🚀 特性

📊 1.信息收集(被动侦察)

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

🔍 2.DNS分析(基础设施发现)

  • DNS记录查找:全面的DNS枚举(A、AAAA、MX、NS、TXT、SPF、DMARC)
  • 反向查询:IP到主机名解析
  • 被动子域枚举:通过crt.sh发现证书透明度日志(隐形)
  • 活动子域枚举:使用subdomains.txt中的单词表进行DNS暴力发现

🌐 3.网络侦察(主动扫描)

  • ip信息:地理位置、ISP和网络详细信息
  • 活体检查:HTTP/HTTPS连接测试和响应分析
  • 端口扫描:与多种扫描模式的高级Nmap集成

🔒 4.Web应用程序分析(应用层)

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

🛠 安装

先决条件

  • Python 3.10+
  • UV包装管理器 (通过脚本自动安装)
  • 扫描器 (通过脚本自动安装)

快速安装

Windows(PowerShell)

.\install.ps1

Linux/macOS

chmod +x install.sh
./install.sh

Claude桌面配置

将此配置添加到您的Claude Desktop设置中,以连接MCP Web侦察服务器:

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 带有克隆存储库的实际路径

配置文件位置:

  • 视窗: %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

🔧 配置

自定义用户代理

对于需要特定标识的漏洞赏金计划,基于HTTP的工具支持可选 user_agent 参数。提供后,它将替换所有发送到目标的HTTP请求的默认用户代理。

示例:

# 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")

支持自定义用户代理的工具:

  • 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桌面聊天中提供自定义单词表

端口扫描选项

端口扫描仪支持针对不同场景优化的各种模式:

  • "common":共同事务(21、22、23、25、53、80443等)
  • "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许可证获得许可-有关详细信息,请参阅许可证文件。

⚠️ 免责声明

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

始终遵循负责任的披露实践,并尊重漏洞赏金计划中的范围限制。