reconFTW MCP服务器
](https://hub.docker.com/r/six2dez/reconftw)  
reconFTW MCP服务器 是令人难以置信的强大的包装 侦察 侦察框架。该项目使人工智能助手能够利用由 six2dez.
🎯 特性
- 完全重构集成:通过MCP工具访问所有侦察功能
- 多种扫描模式:完整、被动、子域、漏洞、OSINT等
- 实时状态:监控扫描进度并按需获取结果
- 资源访问:将扫描结果作为MCP资源访问
- 双重运输:STDIO用于本地AI助手,SSE用于远程访问
- Docker就绪:预配置Docker和Docker组合设置
🚀 快速开始
选项1:Docker(推荐)
# Clone the repository
git clone https://github.com/your-org/reconftw-mcp.git
cd reconftw-mcp
# Build and run (SSE mode)
docker-compose up -d
# MCP server will be available at http://localhost:8002/sse选项2:Docker Direct
# Build the image
docker build -t reconftw-mcp .
# Run in SSE mode (for remote access)
docker run -p 8002:8002 -v reconftw-output:/opt/reconftw/output reconftw-mcp mcp --sse
# Run in STDIO mode (for Claude Code)
docker run -i -v reconftw-output:/opt/reconftw/output reconftw-mcp mcp选项3:本地安装
# Install reconFTW first
git clone --depth 1 https://github.com/six2dez/reconftw.git ~/reconftw
cd ~/reconftw && ./install.sh
# Install MCP server
pip install -r requirements.txt
# Run the MCP server
python mcp_server.py🔧 配置
环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
RECONFTW_DIR | reconFTW安装目录 | /root/reconftw |
OUTPUT_DIR | 扫描输出目录 | /opt/reconftw/output |
MCP_PORT | MCP SSE服务器端口 | 8002 |
SSE_MODE | 默认情况下启用SSE模式 | false |
API密钥(可选)
为了增强侦察功能,请在您的环境中配置API密钥或 .env 文件:
SHODAN_API_KEY=your_shodan_key
VIRUSTOTAL_API_KEY=your_vt_key
CENSYS_API_ID=your_censys_id
CENSYS_API_SECRET=your_censys_secret
# ... see reconFTW documentation for all supported APIs📖 MCP工具
扫描工具
| 工具 | 说明 |
|---|---|
start_recon | 开始全面侦察扫描 |
quick_recon | 快速被动侦察 |
subdomain_enum | 子域枚举 |
vulnerability_scan | 漏洞扫描 |
osint_scan | OSINT聚会 |
状态和结果
| 工具 | 说明 |
|---|---|
get_scan_status | 检查扫描进度 |
list_results | 列出可用扫描 |
get_findings | 获取扫描结果 |
get_nuclei_results | 获取Nuclei漏洞结果 |
控制
| 工具 | 说明 |
|---|---|
stop_scan | 停止正在运行的扫描 |
🔌 与AI助手集成
克劳德码(stdio模式)
添加到您的Claude代码配置中:
{
"mcpServers": {
"reconftw": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-v",
"reconftw-output:/opt/reconftw/output",
"reconftw-mcp",
"mcp"
]
}
}
}远程MCP客户端(SSE模式)
连接到 http://localhost:8002/sse (或您的服务器URL)。
Claude使用示例
User: Can you scan example.com for subdomains?
Claude: I'll start a subdomain enumeration scan for example.com.
[Claude calls subdomain_enum tool]
Claude: I've started scan #1 for example.com. Let me check the status...
[Claude calls get_scan_status tool]
Claude: The scan is running. I found 45 subdomains so far. Would you like me to wait for completion or get the current results?📁 项目结构
reconftw-mcp/
├── Dockerfile # Docker image definition
├── docker-compose.yml # Docker Compose configuration
├── mcp_server.py # Main MCP server
├── tools.py # MCP tools implementation
├── resources.py # MCP resources implementation
├── entrypoint.sh # Container entrypoint
├── requirements.txt # Python dependencies
└── README.md # This file🛠️ 扫描模式
| 模式 | 描述 | 持续时间 |
|---|---|---|
full | 完成侦察 | 1-4小时 |
passive | 仅无源光源 | 10-30分钟 |
subdomains | 子域枚举 | 20-60分钟 |
vulns | 漏洞扫描 | 30-90分钟 |
osint | OSINT采集 | 15-45分钟 |
webs | 仅限网络分析 | 20-60分钟 |
hosts | 仅主机分析 | 15-45分钟 |
📊 MCP资源
通过MCP资源访问扫描数据:
scan://list-列出所有可用的扫描scan://results/{scan_name}-获取扫描结果scan://results/{scan_name}/{file_type}-获取特定结果文件config://reconftw-获取reconFTW配置docs://tools-工具文档docs://modes-扫描模式文档
⚠️ 免责声明
重要:未经事先同意使用此工具攻击目标是非法的。用户有责任遵守所有适用的法律。开发人员对该工具造成的误用或损坏不承担任何责任。
仅使用此工具:
- 在您拥有的系统上
- 经所有者明确许可
- 根据所有适用的法律法规
🤝 贡献
欢迎投稿!请随时提交拉取请求。
- 分叉存储库
- 创建功能分支(
git checkout -b feature/AmazingFeature) - 提交您的更改(
git commit -m 'Add some AmazingFeature') - 推到分支(
git push origin feature/AmazingFeature) - 打开拉取请求
📝 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🙏 致谢
📮 支持
- 问题:
- Discord 的中文翻译是“不和谐”或“纷争”。: reconFTW不一致
- 文档: reconFTW文档
