Osint Mcp

osint-mcp — 面向 AI Agent 的免费 OSINT 工具（MCP 工具）

一条命令。26 个免费 OSINT 工具。适用于任何 AI Agent。

uvx osint-mcp   # installs everything and starts the MCP server

---

什么是 osint-mcp？

osint-mcp 是一个 Python 包，可将 26 个免费的 OSINT（开源情报） 工具封装为 MCP（模型上下文协议） 工具，让 Claude、GPT-4 等 AI Agent 以及任何兼容 MCP 的 Agent 能够直接在对话中开展实际的 OSINT 调查。

它解决的问题： 传统上，运行 OSINT 工具需要安装十几个独立的二进制程序、编写胶水脚本并手动解析输出。osint-mcp 会自动完成整个设置流程——检测操作系统，通过 Homebrew / apt / Go / pip 安装所有工具，并通过单个 MCP 服务将它们提供给 AI Agent。

适用人群：

• 希望借助 AI 开展侦察的安全研究人员和渗透测试人员
• 构建具备安全调查能力的 AI Agent 的开发者
• 自动执行初步信息收集的漏洞赏金猎人
• 扩充 IOC（失陷指标）信息的威胁情报分析师
• 在 AI 指导下学习 OSINT 的学生

---

主要功能

• 26 个免费 OSINT 工具，涵盖网络、域名、社交媒体、电子邮件、Web、电话和密钥扫描
• 一条命令完成设置 — uvx osint-mcp 首次运行时会自动安装所有底层工具
• 原生支持 MCP — 开箱即用，兼容 Claude Desktop、任何 MCP 客户端或 Anthropic SDK
• 大多数工具无需配置 — 15 个工具完全不需要 API 密钥
• 优雅降级 — 带有可选免费 API 密钥的工具（Shodan、VirusTotal）无需密钥也能以精简模式运行，并会明确告知如何启用完整功能
• 支持 macOS + Linux（自动检测 Homebrew、apt、yum、Go、pip）
• 默认安全 — 仅进行被动侦察，除非你明确调用端口扫描或密钥扫描工具

---

一条命令完成设置（推荐）

uvx 相当于 Python 版的 npx——它会在隔离环境中安装软件包并立即运行。无需执行 pip install，也无需设置虚拟环境。

uvx osint-mcp

首次运行时，它会自动：

1. 在隔离的 Python 环境中安装 osint-mcp
2. 检测你的操作系统（macOS 或 Linux）
3. 通过 Homebrew / apt / Go / uv pip 安装全部 26 个 OSINT 工具的二进制程序
4. 在 stdio 上启动 MCP 服务（可供 Claude Desktop 或任何 MCP 客户端使用）

后续运行时，启动时间不到一秒——工具已经安装完毕。

---

连接到 Claude Desktop

在 Claude Desktop 配置中添加一条配置即可。

macOS — ~/Library/Application Support/Claude/claude_desktop_config.json
Linux — ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "osint": {
      "command": "uvx",
      "args": ["osint-mcp"]
    }
  }
}

重启 Claude Desktop。工具列表中会显示 26 个新的 OSINT 工具。

---

替代方案：传统 pip 安装

如果你更愿意自行管理环境：

pip install osint-mcp

# Install all OSINT tool binaries
osint-mcp install

# Check what is available
osint-mcp status

# Start the MCP server
osint-mcp serve

---

工作原理

Claude Desktop / AI Agent
        │
        │  MCP (stdio)
        ▼
  osint-mcp server
        │
        ├── osint_whois        →  python-whois library
        ├── osint_port_scan    →  nmap binary (subprocess)
        ├── osint_subdomain_enum → subfinder binary
        ├── osint_cert_transparency → crt.sh public API (HTTP)
        ├── osint_shodan_host  →  Shodan REST API (optional key)
        ├── osint_virustotal   →  VirusTotal REST API (optional key)
        └── ... 20 more tools

每个工具都是一个 BaseTool 子类。注册表会在启动时自动发现所有子类，并通过 FastMCP 注册它们。如果某个工具的二进制程序尚未安装，它会返回清晰的 "not installed — run osint-mcp install" 消息，而不会崩溃。

---

完整工具参考（26 个工具）

网络情报

MCP 工具	底层技术	是否需要密钥？	功能说明
osint_whois	python-whois	否	WHOIS 查询——注册商、创建日期、到期日期、名称服务器
osint_dns_lookup	dig	否	DNS 记录：A、AAAA、MX、NS、TXT、CNAME、SOA、PTR、SRV、CAA
osint_port_scan	nmap	否	端口和服务扫描，并检测版本
osint_ip_info	ipinfo.io API	可选	IP 地理位置、ISP、组织、时区、滥用联系信息
osint_asn_lookup	ipinfo.io API	可选	ASN 编号、BGP 前缀、网络所有者

域名与 DNS 情报

MCP 工具	底层技术	是否需要密钥？	功能说明
osint_subdomain_enum	subfinder	否	从 40 多个来源被动枚举子域名
osint_amass	amass	否	深入绘制 DNS、证书和 API 的攻击面
osint_cert_transparency	crt.sh API	否	搜索证书透明度日志——通过 SSL 证书发现子域名
osint_harvester	theHarvester	否	从公开来源获取电子邮件地址、主机名和员工姓名
osint_dnsrecon	dnsrecon	否	尝试区域传送、枚举 SRV 记录、执行反向查询

社交媒体与用户名 OSINT

MCP 工具	底层技术	是否需要密钥？	功能说明
osint_username_search	Sherlock	否	在 300 多个社交平台上搜索用户名
osint_maigret	Maigret	否	在 3,000 多个网站上深入分析用户名并提取个人资料

电子邮件情报

MCP 工具	底层技术	是否需要密钥？	功能说明
osint_email_accounts	Holehe	否	查找与某个电子邮件地址关联的服务（Instagram、Twitter 等）
osint_email_breach	HaveIBeenPwned	可选	检查某个电子邮件地址是否出现在已知数据泄露事件中

Web 与威胁情报

MCP 工具	底层技术	是否需要密钥？	功能说明
osint_wayback	Internet Archive API	否	从 Wayback Machine 获取任意 URL 的历史快照
osint_urlscan	urlscan.io API	可选	扫描 URL——返回访问的 IP、技术栈、截图和威胁评分
osint_shodan_host	Shodan API	必需（免费）	查询任意 IP 的开放端口、服务、横幅信息和 CVE
osint_shodan_search	Shodan API	必需（免费）	使用 Shodan 查询语法搜索联网设备
osint_virustotal	VirusTotal API	必需（免费）	使用 70 多种杀毒引擎检查 URL、IP、域名或文件哈希

电话号码 OSINT

MCP 工具	底层技术	是否需要密钥？	功能说明
osint_phone_info	PhoneInfoga	否	查询电话号码的运营商、国家、线路类型，并搜索公开来源

密钥与代码扫描

MCP 工具	底层技术	是否需要密钥？	功能说明
osint_scan_secrets	TruffleHog	否	扫描 Git 仓库 URL 或本地路径，查找暴露的密钥和 API 密钥
osint_gitleaks	Gitleaks	否	检测 Git 历史记录中硬编码的密码和令牌

元数据 / 实用工具

MCP 工具	功能说明
osint_install_status	所有工具及其可用状态的 JSON 列表——便于 Agent 在运行前检查
osint_config_get	读取已存储的 API 密钥（已屏蔽）
osint_config_set	在 Agent 对话中存储 API 密钥
osint_config_list	列出所有已配置的 API 密钥

---

可选免费 API 密钥

这些工具无需密钥即可使用，但使用密钥可解锁更多数据。所有密钥均可免费注册。

工具	配置密钥	免费额度	注册地址
Shodan	shodan_key	1 次查询/秒，100 条结果	https://account.shodan.io
VirusTotal	virustotal_key	4 次请求/分钟	https://www.virustotal.com/gui/join-us
ipinfo.io	ipinfo_key	50,000 次请求/月	https://ipinfo.io/signup
HaveIBeenPwned	hibp_key	可免费查询电子邮件	https://haveibeenpwned.com/API/Key
urlscan.io	urlscan_key	100 次扫描/天	https://urlscan.io/user/signup

# Set a key via CLI
osint-mcp config set shodan_key=YOUR_KEY

# Or let your AI agent set it during a conversation (via osint_config_set tool)

---

AI Agent 对话示例

连接到 Claude Desktop 后，你可以提出类似这样的问题：

“调查域名 example.com——查找子域名，检查联系邮箱是否涉及数据泄露，并在 Shodan 上查询。”

“扫描 GitHub 仓库 github.com/org/repo，查找暴露的密钥和 API 密钥。”

“查找与用户名 johndoe123 关联的所有社交媒体账号。”

“检查 IP 1.2.3.4 是否列在 Shodan 上，以及开放了哪些端口。”

“查询电话号码 +14155552671，找出其注册的运营商和国家/地区。”

Agent 会自动串联多个工具、解读结果，并呈现连贯的调查摘要——无需手动编排工具。

---

CLI 参考

osint-mcp                          Start the MCP server (default, same as serve)
osint-mcp serve                    Start the MCP server explicitly
osint-mcp serve --no-auto-install  Skip first-run tool installation
osint-mcp install                  Install all missing OSINT tools
osint-mcp install --category X     Install only tools in category (network/domain/social…)
osint-mcp install --dry-run        Preview what would be installed
osint-mcp status                   Show a table of all tools and their availability
osint-mcp config set KEY=VALUE     Store an API key
osint-mcp config get KEY           Read a stored key (masked)
osint-mcp config list              List all stored keys
osint-mcp config delete KEY        Remove a key
osint-mcp --version                Print version
osint-mcp --help                   Show help

---

支持的平台

平台	工具安装方式
macOS	Homebrew（brew install） · go install · uv pip install
Linux（Debian / Ubuntu）	apt-get install · go install · uv pip install
Linux（RHEL / Fedora / CentOS）	yum / dnf · go install · uv pip install

自动处理的先决条件：

• Homebrew — macOS 上必须预先安装（https://brew.sh）
• Go 1.21+ — subfinder、amass、phoneinfoga、gitleaks 所需（如果不存在，安装程序会自动跳过）
• Python 3.10+ — 必需（使用 uvx 时会随附）

---

常见问题

问：什么是 MCP（Model Context Protocol）？
答：MCP 是 Anthropic 制定的一项开放标准，可让 AI 模型以结构化且安全的方式调用外部工具。对于 AI Agent 来说，MCP 就像 HTTP 对于 Web 浏览器一样，是一种通用的工具调用协议。了解详情，请访问 modelcontextprotocol.io。

问：osint-mcp 能与 Claude 以外的 AI Agent 配合使用吗？
答：可以。任何兼容 MCP 的客户端都能使用，包括 OpenAI 的 Agent 框架（通过 MCP 适配器）、LangChain、LlamaIndex，以及使用 Anthropic SDK 构建的自定义 Agent。服务通过标准 MCP JSON-RPC 协议，使用 stdio 进行通信。

问：需要付费吗？
答：软件包本身免费且开源。全部 26 个工具均可免费使用。部分工具（Shodan、VirusTotal）需要注册免费的 API 密钥才能使用全部功能，但也提供可用的免费套餐。

问：安全吗？它会未经我许可运行扫描吗？
答：被动工具（WHOIS、证书透明度、数据泄露数据库、用户名搜索）会自动运行。主动工具（使用 nmap 进行端口扫描、使用 TruffleHog 扫描机密信息）只会在你或你的 Agent 明确调用时运行，而且服务说明会提醒 Agent 在主动扫描前征求用户确认。

问：这与手动运行 OSINT 工具有何不同？
答：主要有三点：（1）安装——一条命令即可安装所有内容，无需数小时配置。（2）集成——你的 AI Agent 可以自动串联多个工具，并解读综合结果。（3）对话——你只需用通俗易懂的英语描述需求，无需记忆 CLI 参数。

问：安装 osint-mcp 时，uvx 和 pip 有什么区别？
答：uvx osint-mcp（推荐）会在隔离环境中运行软件包，无需全局安装 pip，也无需设置虚拟环境。pip install osint-mcp 则会将其安装到当前环境中。两种方式都可行；uvx 更简单，也能避免依赖冲突。

问：我可以添加自己的 OSINT 工具吗？
答：可以。在 src/osint_mcp/tools/<category>/ 下的任意文件中创建 BaseTool 子类，注册表会在下次启动时自动发现它。无需手动注册。接口详情请参阅 tools/base.py。

---

合乎道德与法律地使用

osint-mcp 旨在用于经授权的安全研究、获得书面许可的渗透测试、威胁情报、漏洞赏金搜寻和教育。

请勿使用这些工具进行以下行为：

• 未经个人同意或缺乏法律授权，调查该个人
• 访问或探测你不拥有或未获准测试的系统
• 违反任何第三方 API 或数据源的服务条款

适用法律包括《计算机欺诈和滥用法案》（CFAA，美国）、《计算机滥用法》（英国）、《通用数据保护条例》（GDPR，欧盟），以及你所在司法管辖区的同等法律。作者对滥用行为不承担任何责任。

---

贡献

欢迎贡献，包括新增工具、改进安装说明、修复错误和完善文档。

git clone https://github.com/rjn32s/osint-mcp
cd osint-mcp
uv venv && uv pip install -e ".[dev]"
osint-mcp status   # verify your setup

要添加新的 OSINT 工具，请在 src/osint_mcp/tools/<category>/yourfile.py 中创建 BaseTool 子类。该类需要包含 name、description、input_schema 和 async run(args) 方法。注册表会自动发现该类。

---

相关项目

• Sherlock — 跨社交网络进行用户名 OSINT 搜索
• subfinder — 快速被动枚举子域名
• amass — OWASP 攻击面映射
• theHarvester — 收集电子邮件地址和主机信息
• TruffleHog — 检测 Git 中的机密信息
• MCP Python SDK — 此服务实现的协议

---

许可证

MIT © 2026 Rajan Shukla

---

mcp-name: io.github.rjn32s/osint-mcp