Repolode
w0h1v

w0h1v/mcp-shodan

让 AI 智能体调用 Shodan API 与 CVEDB 的 MCP 服务,用于联网设备搜索、主机侦察、DNS 与 CVE 情报查询。

可替代:Shodan

Star
187
Fork
31
未关闭 Issue
3
最近提交
3天前

这是什么?

mcp-shodan 是一个 MCP 服务器,让 Claude、Codex、Gemini CLI 等 AI 智能体可以直接调用 Shodan API 和 Shodan CVEDB。输入 IP、域名、搜索语句、产品或 CVE 编号后,智能体可返回开放端口与服务横幅、TLS 证书信息、DNS 记录,以及带 EPSS 和 KEV 状态的漏洞严重程度。

服务提供 11 个只读工具,分为三类:网络查询(主机信息、设备搜索、结果计数、子域名与批量 DNS 解析)、基于 CVEDB 的漏洞情报(CVE 详情、CPE 查询、按产品检索 CVE),以及列出搜索过滤器和剩余 API 额度的辅助工具。免费工具已在说明中标注,CVEDB 调用无需 API Key。

支持 stdio 传输供桌面客户端使用,也可以以 HTTP 流式服务运行。运行环境需要 Node.js 20 及以上和自己的 Shodan API Key。请求发送前会用 zod 校验输入,API Key 仅发送至 api.shodan.io。

核心功能

  • 01对 IPv4 和 IPv6 地址进行主机侦察,包括端口、产品、CVE 与 TLS 信息。
  • 02使用 Shodan 查询语法搜索设备,支持分页和 facet 统计。
  • 03提供免费的仅计数查询,便于在消耗额度前评估搜索规模。
  • 04通过 CVEDB 查询 CVE 与 CPE,包含 CVSS、EPSS 和 KEV 数据。
  • 05支持批量正向与反向 DNS 查询及子域名枚举。
  • 06同时支持 stdio 与 HTTP 流式传输,并提供 Docker 镜像。

适用场景

  • 安全评估时让 AI 智能体查询某个 IP 暴露了哪些服务。
  • 检查某个 CVE 是否在 KEV 目录中,并结合 EPSS 评分判断被利用的可能性。
  • 在执行付费搜索前,用免费计数查询估算全网搜索规模。
  • 为外部攻击面梳理枚举子域名并解析 DNS 记录。

快速上手

  1. 1

    从 Shodan 账户页面获取 API 密钥

  2. 2

    将服务器添加到 Claude Code

    claude mcp add --transport stdio --env SHODAN_API_KEY=your-key shodan -- npx -y @burtthecoder/mcp-shodan

使用前须知

  • 需要您自己的 Shodan API 密钥,且搜索过滤器需要会员或付费套餐。
  • HTTP 传输没有身份验证,因此必须仅限本地访问或置于带身份验证的反向代理之后。

收录于专题

标签

常见问题

mcp-shodan 是什么?
让 AI 智能体调用 Shodan API 与 CVEDB 的 MCP 服务,用于联网设备搜索、主机侦察、DNS 与 CVE 情报查询。 mcp-shodan 是一个 MCP 服务器,让 Claude、Codex、Gemini CLI 等 AI 智能体可以直接调用 Shodan API 和 Shodan CVEDB。输入 IP、域名、搜索语句、产品或 CVE 编号后,智能体可返回开放端口与服务横幅、TLS 证书信息、DNS 记录,以及带 EPSS 和 KEV 状态的漏洞严重程度。
mcp-shodan 可以免费使用吗?用的什么许可证?
mcp-shodan 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
mcp-shodan 还在维护吗?
活跃维护中。mcp-shodan 最近一次提交是在 2026年11月4日。
mcp-shodan 适合用来做什么?
安全评估时让 AI 智能体查询某个 IP 暴露了哪些服务。 检查某个 CVE 是否在 KEV 目录中,并结合 EPSS 评分判断被利用的可能性。 在执行付费搜索前,用免费计数查询估算全网搜索规模。 为外部攻击面梳理枚举子域名并解析 DNS 记录。
mcp-shodan 怎么安装和运行?
从 Shodan 账户页面获取 API 密钥 将服务器添加到 Claude Code: claude mcp add --transport stdio --env SHODAN_API_KEY=your-key shodan -- npx -y @burtthecoder/mcp-shodan
在哪里获取 mcp-shodan?
源代码和安装说明在 GitHub 上:https://github.com/w0h1v/mcp-shodan

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目