使用说明
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许可证获得许可-有关详细信息,请参阅许可证文件。
⚠️ 免责声明
此工具仅用于合法的安全研究、渗透测试和漏洞赏金活动。用户有责任确保在扫描或测试任何网络、系统或应用程序之前获得适当的授权。作者不对任何滥用此工具的行为负责。
始终遵循负责任的披露实践,并尊重漏洞赏金计划中的范围限制。
