使用说明
🕵️ PenTest OSINT MCP服务器
将Claude Desktop变成一个完整的OSINT工作站。
一个模型上下文协议(MCP)服务器,将25+开源OSINT和侦察工具集成到Claude Desktop中。在Kali Linux上实现了单命令部署的Docker化。由戊酯制成,用于戊酯。
这有什么作用
您无需在运行不同工具的15个终端选项卡之间切换,只需与Claude交谈,它就会为您运行它们。请克劳德:
- “在target.com上运行完全被动侦察” → 链WHOIS+DNS+crt.sh+收割机+子编码器+dnstwist
- “在所有平台上搜索用户名johndoe” → 运行Sherlock+Maigret+Blackbird
- “检查此电子邮件中的违规行为和平台注册” → 运行Holehe + h8mail
- “扫描10.0.0.1以查找打开的端口” → 使用您偏好的扫描类型运行Nmap
- “为target.com生成谷歌傻瓜” → 输出20+最重要的dork查询
所有结果都会在聊天中返回。无复制粘贴。无标签切换。
🛠️ 集成工具(25+)
用户名OSINT
| 工具 | 覆盖范围 | 描述 |
|---|---|---|
| 夏洛克 | 400+个网站 | 社交媒体用户名搜索 |
| 马格雷 | 3000多个网站 | 具有假阳性检测功能的高级用户名搜索 |
| 乌鸫 | 581个站点 | 快速用户名枚举 |
Osint电子邮件
| 工具 | 说明 |
|---|---|
| 霍莱赫 | 在120多个平台上检查电子邮件注册 |
| h8邮件 | 漏洞数据库搜索(支持HIBP、LeakCheck、EmailRep API密钥) |
域和基础架构
| 工具 | 说明 |
|---|---|
| 收割机 | 来自公共来源的电子邮件、子域、主机 |
| 子查找器 | 被动子域枚举 |
| 积聚 | OWASP子域枚举 |
| 谁 | 域名/IP注册查询 |
| 挖 | DNS记录查询(A、MX、NS、TXT等) |
| dnstwist | 打字和钓鱼域名检测 |
| crt.sh | 证书透明度日志搜索 |
| 时间机器 | 历史URL发现 |
| WhatWeb | 网站技术指纹识别 |
网络和IP
| 工具 | 说明 |
|---|---|
| 扫描器 | 端口扫描(快速、版本、操作系统、完整、漏洞、隐形) |
| 肖丹 | Internet连接的设备搜索(需要API密钥) |
| 病毒总数 | 域/IP/URL恶意软件分析(需要API密钥) |
电话OSINT
| 工具 | 说明 |
|---|---|
| PhoneInfoga | 电话号码运营商、位置和OSINT数据 |
全面的
| 工具 | 说明 |
|---|---|
| 蜘蛛脚 | 全自动OSINT扫描(5-30分钟) |
| 侦察 | 模块化侦察框架 |
帮手
| 工具 | 说明 |
|---|---|
| 谷歌多克斯 | 生成以pentest为中心的dork查询(文件、登录、公开、机密、云) |
| GitHub Recon | 在GitHub上搜索泄露的代码和秘密 |
| 全被动侦察 | 一个命令链:WHOIS→ DNS → crt.sh→ 收割机→ 子查找器→ dnstwist |
🚀 快速入门(Docker)
先决条件
- Docker&Docker编写
- 克劳德桌面
1.克隆和构建
git clone https://github.com/Hackerobi/pentest-osint-mcp-server.git
cd pentest-osint-mcp-server
docker compose build
docker compose up -d
2.配置克劳德桌面
将配置复制到您的Claude Desktop配置文件:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"pentest-osint": {
"command": "docker",
"args": [
"exec", "-i", "pentest-osint-mcp",
"python3", "/opt/osint-mcp/server.py"
],
"env": {
"PYTHONUNBUFFERED": "1"
}
}
}
}
3.重新启动克劳德桌面
工具将自动显示。开始让Claude运行OSINT查询。
🔑 API密钥管理
某些工具需要API密钥才能实现全部功能。三种配置方式:
选项1:问克劳德
在聊天中告诉克劳德:
“将我的Shodan API密钥设置为abc123def456”
选项2:交互式脚本
bash scripts/setup_keys.sh
选项3:直接编辑JSON
vim ~/.osint-mcp/api_keys.json
支持的API服务(21)
| 服务 | 免费等级 | 获取密钥 |
|---|---|---|
| Shodan | 有限公司 | https://account.shodan.io/ |
| VirusTotal | 每天需要500次 | https://www.virustotal.com/gui/my-apikey |
| Hunter.io | 每月需要25次 | https://hunter.io/api-keys |
| 安全追踪 | 每月需要50次 | https://securitytrails.com/app/account |
| Censys | 每月250个需求 | https://search.censys.io/account/api |
| GitHub | 慷慨 | https://github.com/settings/tokens |
| 我被贿赂了吗https://haveibeenpwned.com/API/Key | ||
| 灰噪声 | 有限 | https://viz.greynoise.io/account/api-key |
| BinaryEdge | 每月250个需求 | https://app.binaryedge.io/account/api |
| 情报X | 有限 | https://intelx.io/account?tab=developer |
| 还有11个。.. | 请参阅 scripts/setup_keys.sh |
🐧 原生安装(Kali/Ubunt/Debian)
如果你更喜欢在没有Docker的情况下运行:
git clone https://github.com/Hackerobi/pentest-osint-mcp-server.git
cd pentest-osint-mcp-server
sudo bash scripts/install.sh
然后更新您的Claude Desktop配置,使其直接指向服务器:
{
"mcpServers": {
"pentest-osint": {
"command": "python3",
"args": ["/opt/osint-mcp/server.py"],
"env": {"PYTHONUNBUFFERED": "1"}
}
}
}
📁 项目结构
pentest-osint-mcp-server/
├── src/
│ └── server.py # MCP server (single-file, ~900 lines)
├── scripts/
│ ├── install.sh # Native Kali/Ubuntu installer
│ └── setup_keys.sh # Interactive API key configuration
├── configs/
│ └── claude_desktop_config.example.json
├── Dockerfile # Kali-based container
├── docker-compose.yml
└── README.md
💡 使用示例
全被动侦察
“在example.com上运行完全被动侦察”
自动链接6个工具并返回组合报告。
用户名调查
“使用Maigret在所有平台上搜索用户名targetuser”
返回已确认的配置文件和提取的元数据(全名、头像、帐户创建日期)。
电子邮件智能
“检查test@example.com平台注册和违规”
同时运行Holehe(平台检测)和h8mail(漏洞检查)。
网络扫描
“在scanme.nmap.org端口22,80443上运行版本扫描”
使用以下命令执行Nmap -sV 标记并返回格式化的结果。
打字错误检测
“检查是否有针对example.com的域名拼写错误”
运行dnstwist并返回所有已注册的相似域名。
⚠️ 法律免责声明
此工具用于 仅限授权渗透测试和安全研究。在扫描目标之前,始终确保您有适当的授权。未经授权访问计算机系统是非法的。
作者不对误用此工具负责。
🤝 贡献
欢迎拉取请求。如果要添加新工具:
- 在中添加处理程序函数
server.py - 将工具定义添加到
TOOLS列表 - 将处理程序添加到
HANDLER_MAP - 如果需要新的依赖项,请更新Dockerfile
- 提交PR
📬 联系
- 不一致: sgtwolf787
- github: @哈克罗比
白帽子或不戴帽子🎩
与克劳德一起建造。在授权的目标上进行测试。保持合法。