# @burtthecoder/mcp-shodan 中文文档
规范地址：https://npmcn.com/package/%40burtthecoder/mcp-shodan/
版本：1\.0\.37
npm 元数据更新时间：2026-11-04T21:15:41.315Z
中文译文更新时间：2026-11-08T20:23:27.504Z
软件包许可：MIT
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40burtthecoder/mcp-shodan
原文对照：https://npmcn.com/package/%40burtthecoder/mcp-shodan/?lang=original
项目主页：https://w0h1v.github.io/mcp-shodan/
源码仓库：https://github.com/w0h1v/mcp-shodan
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：51.1 kB，17 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：4 个
- 首次发布：2024-12-12T18:37:37.597Z
- 最新版本发布：2026-11-04T21:15:40.974Z
- 近 30 天下载量：3983（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 11 个）
## 中文简介
Shodan API 查询的模型上下文协议服务器 .
## 安装
```sh
npm install @burtthecoder/mcp-shodan
```
也可以使用：`pnpm add @burtthecoder/mcp-shodan`、`yarn add @burtthecoder/mcp-shodan`、`bun add @burtthecoder/mcp-shodan`
## README
[](https://www.npmjs.com/package/@burtthecoder/mcp-shodan) [](https://github.com/w0h1v/mcp-shodan/actions/workflows/ci.yml) [](https://npmcn.com/package/%40burtthecoder/mcp-shodan/LICENSE)  [](https://registry.modelcontextprotocol.io/)
[快速启动](https://npmcn.com/package/%40burtthecoder/mcp-shodan/#readme-quickstart) • 妇女 [工具](https://npmcn.com/package/%40burtthecoder/mcp-shodan/#readme-tools) • 妇女 [HTTP 密码](https://npmcn.com/package/%40burtthecoder/mcp-shodan/#readme-http-streaming-transport) • 妇女 [警卫](https://npmcn.com/package/%40burtthecoder/mcp-shodan/#readme-security) • 妇女 [解决问题](https://npmcn.com/package/%40burtthecoder/mcp-shodan/#readme-troubleshooting) • 妇女 [文档](https://w0h1v.github.io/mcp-shodan/)
**米克普-绍丹** 是一个 [MCP 磁共振](https://modelcontextprotocol.io/) 允许 AI 代理机访问 [肖丹 API](https://developer.shodan.io/api) 财务报告和审定财务报表 [肖丹 CVEDB](https://cvedb.shodan.io/)。将一个IP、主机名、搜索查询、产品或 CVE 交给您的代理,并获得一个分析师将查看的内容:打开端口和横幅、 TLS 证书、 DNS 以及带有 EPSS 和 KEV 状态的脆弱性严重性.
> \[注\] 独立项目,不隶属于肖丹. 你需要你自己来 [Shodan API 密钥](https://account.shodan.io/)。 。 。 .
## 要点
- **主机侦察.** 开放端口,产品和版本,已知的CVES,TLS证书细节(指印,JARM,JA3S),云提供商和任何IPv4或IPv6地址的横幅历史.
- **设备搜索.** 肖丹查询语法有page和facet分解(country, org, port, vuln 等),外加一个免费的只计数模式来表示查询大小.
- **脆弱性情报.** CVE细节有CVSS v4/v3/v2,EPSS和KEV;CVES按产品或CPE分类,由EPSS分类. CVEDB是免费的,不花查询信用.
- **DNS. (英语).** 子域名和 DNS 记录一个域名,并在一个调用中前向和倒向查找许多名称或IP.
- **信用意识.** 免费工具被标记为免费,以及 `api_info` 显示您计划中的积分.
- **二通运.** 用于桌面客户端的stdio,用于共享服务的HTTP流.
- **经验.** 在20号、22号和24号中心用被嘲笑的Shodan API进行单元测试.
## 如何运作
```mermaid
flowchart LR
A["AI agent
(Claude, Codex, Gemini, VS Code)"] -->|"MCP over stdio or HTTP"| S["mcp-shodan"]
S -->|"validate input,
HTTPS + API key"| SH["Shodan REST API"]
S -->|"HTTPS, no key"| C["Shodan CVEDB"]
SH -->|"JSON"| S
C -->|"JSON"| S
S -->|"structured JSON text"| A
```
## 快速启动
**所需经费:** 节点.js 20或更新 和一肖丹 API 键.
```sh
# Claude Code
claude mcp add --transport stdio --env SHODAN_API_KEY=your-key shodan -- npx -y @burtthecoder/mcp-shodan
# Codex CLI
codex mcp add shodan --env SHODAN_API_KEY=your-key -- npx -y @burtthecoder/mcp-shodan
# Gemini CLI
gemini mcp add -e SHODAN_API_KEY=your-key shodan npx -y @burtthecoder/mcp-shodan
```
关于Claude桌面, VS 代码和源代码运行,请参见 [连接客户端](https://npmcn.com/package/%40burtthecoder/mcp-shodan/docs/clients.md)。 。 。 .
那就问问你的经纪人: _"在8.8.8.8上暴露了什么,KEV目录中CVE-2021-44228是什么样的?"_ 更多提示进入 [示例工作流程](https://npmcn.com/package/%40burtthecoder/mcp-shodan/docs/examples.md)。 。 。 .
## 工具
11个只读工具. 全部参数在 [工具参考](https://npmcn.com/package/%40burtthecoder/mcp-shodan/docs/tools.md)。 。 。 .
| 组 | 工具 | 它会做什么 |
| --- | --- | --- |
| 网络 | `ip_lookup` | 一个IP的端口,产品,CVE,TLS,位置和云,可选有横幅历史 |
| | `shodan_search` | 用 Shodan 查询语法搜索设备, 并使用呼和平面分解 |
| | `shodan_count` | 查询的匹配和平面分解总数, 无结果( 免费) |
| | `domain_info` | 一个域的子域和 DNS 记录 |
| | `dns_lookup` | 将主机名确定为 IP, 批次 |
| | `reverse_dns_lookup` | IP 的主机名, 批次 |
| 脆弱性(CVEDB) | `cve_lookup` | CVSS, EPSS, KEV, 一个CVE的参考和受影响的CPE |
| | `cpe_lookup` | CPE 2.3产品名称标识符 |
| | `cves_by_product` | 用于产品或CPE的 CVES,可被 KEV 过滤并被日期,可被 EPSS 排序 |
| 帮助者 | `search_filters` | 有效的搜索过滤器和平面名称 |
| | `api_info` | 你的计划 剩下的查询和扫描信用 |
> \[TIP\] 信用:过滤 `shodan_search` 查询费用为1次查询(每个额外页加1次)和 `domain_info` 开一通电话. `shodan_count`, (中文(简体) ), `ip_lookup`, (中文(简体) ), `dns_lookup`, (中文(简体) ), `reverse_dns_lookup`, (中文(简体) ), `search_filters`, (中文(简体) ), `api_info` cVEDB 工具是免费的.
## HTTP 流线运输
stdio是默认值. 设定 `MCP_TRANSPORT=httpStream` 运行独立的 HTTP 服务 :
```sh
MCP_TRANSPORT=httpStream MCP_PORT=3000 SHODAN_API_KEY=your-key node build/index.js
```
```sh
docker build -t mcp-shodan .
docker run -p 127.0.0.1:3000:3000 -e SHODAN_API_KEY=your-key -e MCP_TRANSPORT=httpStream mcp-shodan
```
健康检查服务于 `/health`。 。 。 .
### 环境变量
| 变量 | 默认 | 说明 |
| --- | --- | --- |
| `SHODAN_API_KEY` | _(必须)_ | 您的 Shodan API 密钥 |
| `MCP_TRANSPORT` | `stdio` | `stdio` 或者说 `httpStream` |
| `MCP_HOST` | `localhost` | 绑定地址( N)`httpStream` 页:1 Docker 图像集 `0.0.0.0` |
| `MCP_PORT` | `3000` | HTTP 端口 (% 1)`httpStream` 仅限) |
| `MCP_ENDPOINT` | `/mcp` | HTTP 端点路径 (`httpStream` 仅限) |
## 警卫
> \[尖叫声\] HTTP运输系统 **无认证**。将端口保留在本地主机上,或者在认证的倒置代理机后,或者任何人可以到达端口时花费您的查询信用值.
- 工具参数在构建任何请求之前先由zod schemas验证. IP必须是有效的 IPv4 或 IPv6, 域为有效的主机名, 侧面 `name[:count]` 列表, CVE ID必须匹配 `CVE-YYYY-NNNN`。 。 。 .
- API 密钥从环境中读取, 只发送到 `api.shodan.io`。CVEDB的电话没有键.
- 你往上看的是寄给肖丹的.
私下报告脆弱性;见 [警卫](https://npmcn.com/package/%40burtthecoder/mcp-shodan/SECURITY.md)。 。 。 .
## 解决问题
- **401 / 无效密钥 :** 检查密钥周围的空格或引用,然后重新启动客户端. `curl "https://api.shodan.io/api-info?key=$SHODAN_API_KEY"` 展示你的计划和功劳.
- **403关 `shodan_search`数字 :** 搜索过滤器需要会员资格或付费API计划. 运行 `api_info` 看看你的计划和功劳.
- **429个:** 肖丹允许每秒约一个请求. 稍后再试.
再来点 [解决问题指南](https://npmcn.com/package/%40burtthecoder/mcp-shodan/docs/troubleshooting.md)。 。 。 .
## 发展
```sh
git clone https://github.com/w0h1v/mcp-shodan && cd mcp-shodan
npm ci
npm test # build + unit tests, no key or network
npx fastmcp dev build/index.js # try tools interactively (needs SHODAN_API_KEY)
```
见 [捐款额](https://npmcn.com/package/%40burtthecoder/mcp-shodan/CONTRIBUTING.md) 编辑 [更改日志](https://npmcn.com/package/%40burtthecoder/mcp-shodan/CHANGELOG.md)。 。 。 .
## 许可证
麻省理工学院. 见 [自由主义](https://npmcn.com/package/%40burtthecoder/mcp-shodan/LICENSE)。 。 。 .
## 常见问题
### @burtthecoder/mcp-shodan 是什么？
Shodan API 查询的模型上下文协议服务器 \.
### 如何安装 @burtthecoder/mcp-shodan？
在项目目录运行 npm install @burtthecoder/mcp-shodan，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp-shodan，可以用 npx mcp-shodan 直接运行。
### @burtthecoder/mcp-shodan 支持 TypeScript 吗？
该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/burtthecoder\_\_mcp-shodan 是否存在。
### @burtthecoder/mcp-shodan 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。
### @burtthecoder/mcp-shodan 需要什么版本的 Node\.js？
package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
### @burtthecoder/mcp-shodan 可以商用吗？
@burtthecoder/mcp-shodan 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
### @burtthecoder/mcp-shodan 的下载量有多少？
根据 npm 官方下载统计，@burtthecoder/mcp-shodan 在 2026/10/09 – 2026/11/07 这 30 天内被下载 3,983 次，日均约 133 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @burtthecoder/mcp-shodan 还在维护吗？
最新版本 1\.0\.37 发布于 2026/11/05（4 天前）；至今共发布 24 个版本，其中过去 12 个月发布了 11 个；首次发布于 2024/12/13。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。