让AI Agent化身OSINT分析师MCP协议连接OpenOSINT与Claude Code完整教程【免费下载链接】OpenOSINTAI-powered OSINT agent with interactive REPL, MCP server, and CLI. 19 tools. Works with Claude, GPT-4, or local models. For authorized security research only.项目地址: https://gitcode.com/gh_mirrors/op/OpenOSINTOpenOSINT 是一款 AI 驱动的开源 OSINT开源情报智能体把邮件溯源、数据泄露查询、IP 信誉、域名侦察等 19 个调查工具装进自然语言界面。本文用MCP 协议一步打通 OpenOSINT 与 Claude Code——不写一行代码让 AI Agent 变成能真正执行调查任务的 OSINT 分析师自动选择工具、按发现链式深挖、输出结构化结论。一、MCP协议是什么AI Agent 的USB-C 接口一句话解释MCPModel Context Protocol是 AI 助手调用外部工具的标准协议就像 USB-C 统一了硬件接口。没有 MCP 时每给 AI 加一个新工具都要单独写提示词和胶水代码有了 MCP 后注册一次Claude Code 等兼容客户端就能原生看到并调用全部工具OpenOSINT 内置了现成的 MCP Server源码位于openosint/mcp_server.py它通过标准 I/O 把 19 个 OSINT 工具和批量调查能力一次性开放给 AI 客户端。二、为什么这个组合值得尝试痛点通过 MCP 连接后AI 一本正经地编造结果AI 只发出硬性工具调用真实代码执行结果不可能是幻觉手动逐个挑选工具AI 根据发现自动链式调用邮件 → 用户名 → 泄露库终端之间来回切换、上下文丢失所有工具调用在同一会话内完成上下文自动保持同样的 19 个工具在 OpenOSINT Web 界面中的表现本教程会把它们搬进 Claude Code。三、准备工作安装 OpenOSINT3 步完成要求Python 3.10 以及已安装的 Claude Code。git clone https://gitcode.com/gh_mirrors/op/OpenOSINT cd OpenOSINT pip install -e .然后在项目根目录创建.env文件配置 API Key按需配置缺 Key 的工具会返回友好错误其余工具照常可用ANTHROPIC_API_KEYsk-ant-... # AI Agent 的大脑 HIBP_API_KEY... # 泄露查询可选 ABUSEIPDB_API_KEY... # IP 滥用信誉可选完整 Key 清单见项目 README 的 Configuration 章节每个变量都标注了对应工具。四、一行命令把 MCP Server 接入 Claude Code这是整个教程最关键的一步只需一条命令claude mcp add openosint python /绝对路径/OpenOSINT/openosint/mcp_server.py再验证连接状态claude mcp list # openosint python .../mcp_server.py (connected)看到connected就意味着 19 个 OSINT 工具已出现在 Claude Code 的工具面板里。 小贴士如果连接失败90% 是因为命令中使用了相对路径——MCP Server 的路径必须是绝对路径。五、首次调查用一句话完成目标溯源运行claude进入会话用自然语言下达任务 Investigate demoexample.com. Check for linked social accounts and breach exposure, and produce a summary.接下来你会看到类似分析师的工作过程- generate_dorks(demoexample.com) - search_email(demoexample.com) Found: Spotify, GitHub, WordPress, Gravatar - search_breach(demoexample.com) Found in 2 breaches: LinkedIn (2016), Adobe (2013) - search_username(demo) - AI 从发现中自动跳转AI 自动串联邮箱查询、泄露查询和用户名追踪最后给出带结论的报告。不需要手动选工具也不需要复制粘贴输出。OpenOSINT 交互式 REPL 与 MCP 共用同一个工具引擎AI 工具链行为完全一致。六、进阶玩法Claude Code 独有的能力MCP 接上之后Claude Code 远不止调工具批量调查investigate_multi支持最多 10 个目标并行调查每个目标生成独立报告外加一份汇总报告文件读写让 Claude Code 读取目标清单文件、批量执行调查、把结果直接写成 JSON / CSV自定义自动化用一句写个脚本对 targets.txt 里的域名做 WHOIS 查询并导出 CSV它会直接调用openosint/tools/下的异步工具函数写完、测试并保存脚本AI 生成代码 实时 OSINT 工具的组合让你快速搭出原本不存在的调查自动化。七、常见问题排查Q1某个工具报错提示需要 API Key该工具属于可选 Key 工具Shodan、VirusTotal、Censys 等。在.env补上对应 Key 后重启会话即可其他工具不受影响。Q2Claude Desktop 也能接吗可以。在 Claude Desktop 的claude_desktop_config.json里写入同样的mcp_server.py绝对路径配置即可具体格式见 README 的 MCP Server 章节。Q3想在浏览器里看调查过程和关联图运行openosint web启动 Web UI即可在浏览器中查看流式工具输出和实体关联图八、总结步骤操作1️⃣ 安装pip install -e .2️⃣ 接入claude mcp add openosint python /绝对路径/openosint/mcp_server.py3️⃣ 验证claude mcp list4️⃣ 调查在 Claude 会话里用自然语言下达任务借助 MCP 协议AI Agent 第一次真正长出了双手——而 OpenOSINT 直接递给了它一整套 OSINT 工具箱。你只需负责用自然语言提出任务剩下的交给工具链。⚠️合规提醒OpenOSINT 仅面向合法、已获授权的安全研究使用。执行任何调查前请确保已获得相应授权并阅读DISCLAIMER.md与可接受使用政策legal/ACCEPTABLE_USE_POLICY.md。【免费下载链接】OpenOSINTAI-powered OSINT agent with interactive REPL, MCP server, and CLI. 19 tools. Works with Claude, GPT-4, or local models. For authorized security research only.项目地址: https://gitcode.com/gh_mirrors/op/OpenOSINT创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考