中文名：Shodan查询

modelscope·@BurtTheCoder/mcp-shodan

简介

用于查询Shodan API和Shodan CVEDB的MCP服务器。该服务器提供了IP查询、设备搜索、DNS查询、漏洞查询、CPE查询等工具。

MCP Server 详情

来自 ModelScope 索引

Shodan MCP 服务器

这是一个用于查询 Shodan API 和 Shodan CVEDB 的 Model Context Protocol (MCP) 服务器。该服务器提供了对 Shodan 网络情报和安全服务的全面访问，包括 IP 侦察、DNS 操作、漏洞跟踪和设备发现。所有工具都提供结构化、格式化的输出，以便于分析和集成。

快速开始（推荐）

通过 Smithery 安装

要通过 Smithery 自动安装适用于 Claude Desktop 的 Shodan 服务器：

npx -y @smithery/cli install @burtthecoder/mcp-shodan --client claude

手动安装

通过 npm 全局安装服务器：

npm install -g @burtthecoder/mcp-shodan

添加到你的 Claude Desktop 配置文件中：

{
  "mcpServers": {
    "shodan": {
      "command": "mcp-shodan",
      "env": {
        "SHODAN_API_KEY": "your-shodan-api-key"
      }
    }
  }
}

配置文件位置：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

重启 Claude Desktop

替代设置（从源代码）

如果你更喜欢从源代码运行或需要修改代码：

克隆并构建：

git clone https://github.com/BurtTheCoder/mcp-shodan.git
cd mcp-shodan
npm install
npm run build

添加到你的 Claude Desktop 配置中：

{
  "mcpServers": {
    "shodan": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-shodan/build/index.js"],
      "env": {
        "SHODAN_API_KEY": "your-shodan-api-key"
      }
    }
  }
}

功能

网络侦察：查询有关 IP 地址的详细信息，包括开放端口、服务和漏洞
DNS 操作：针对域名和 IP 地址进行正向和反向 DNS 查找
漏洞情报：访问 Shodan 的 CVEDB 获取详细的漏洞信息、CPE 查询以及特定产品的 CVE 跟踪
设备发现：使用高级过滤搜索 Shodan 的互联网连接设备数据库

工具

1. IP 查找工具

名称：ip_lookup
描述：检索关于 IP 地址的综合信息，包括地理位置、开放端口、正在运行的服务、SSL 证书、主机名以及如果可用的话云提供商详细信息
参数：
- ip（必填）：要查找的 IP 地址
返回：
- IP 信息（地址、组织、ISP、ASN）
- 位置（国家、城市、坐标）
- 服务（端口、协议、横幅）
- 云提供商详情（如果可用）
- 关联的主机名和域名
- 标签

2. Shodan 搜索工具

名称：shodan_search
描述：搜索 Shodan 的互联网连接设备数据库
参数：
- query（必填）：Shodan 搜索查询
- max_results（可选，默认值：10）：返回的结果数量
返回：
- 包含总结果数的搜索摘要
- 基于国家的分布统计
- 详细的设备信息，包括：
  - 基本信息（IP、组织、ISP）
  - 位置数据
  - 服务详情
  - Web 服务器信息
  - 关联的主机名和域名

3. CVE 查找工具

名称: cve_lookup
描述: 从 Shodan 的 CVEDB 查询详细的漏洞信息
参数:
- cve (必填): CVE 标识符格式为 CVE-YYYY-NNNNN（例如，CVE-2021-44228）
返回:
- 基本信息 (ID, 发布日期, 摘要)
- 严重程度评分:
  - CVSS v2 和 v3 以及严重级别
  - EPSS 概率和排名
- 影响评估:
  - KEV 状态
  - 建议的缓解措施
  - 勒索软件关联
- 受影响的产品 (CPEs)
- 参考资料

4. DNS 查找工具

名称: dns_lookup
描述: 使用 Shodan 的 DNS 服务将域名解析为 IP 地址
参数:
- hostnames (必填): 需要解析的主机名数组
返回:
- 将主机名映射到 IP 的 DNS 解析结果
- 总查找次数和查询主机名的摘要

5. 反向 DNS 查找工具

名称: reverse_dns_lookup
描述: 执行反向 DNS 查找以找到与 IP 地址关联的主机名
参数:
- ips (必填): 需要查找的 IP 地址数组
返回:
- 将 IP 映射到主机名的反向 DNS 解析结果
- 总查找次数和结果的摘要

6. CPE 查找工具

名称: cpe_lookup
描述: 通过产品名称搜索通用平台枚举 (CPE) 条目
参数:
- product (必填): 要搜索的产品名称
- count (可选，默认值: false): 如果为 true，则仅返回匹配 CPE 的数量
- skip (可选，默认值: 0): 跳过的 CPE 数量（用于分页）
- limit (可选，默认值: 1000): 最大返回 CPE 数量
返回:
- 当 count 为 true 时: 匹配 CPE 的总数
- 当 count 为 false 时: 带有分页详情的 CPE 列表

7. 按产品查找 CVE 工具

名称: cves_by_product
描述: 搜索影响特定产品或 CPE 的漏洞
参数:
- cpe23 (可选): CPE 2.3 标识符 (格式: cpe:2.3:part:vendor:product:version)
- product (可选): 要搜索 CVE 的产品名称
- count (可选，默认值: false): 如果为 true，则仅返回匹配 CVE 的数量
- is_kev (可选，默认值: false): 如果为 true，则仅返回带有 KEV 标志的 CVE
- sort_by_epss (可选，默认值: false): 如果为 true，则按 EPSS 分数对 CVE 进行排序
- skip (可选，默认值: 0): 要跳过的 CVE 数量（用于分页）
- limit (可选，默认值: 1000): 最大返回 CVE 数量
- start_date (可选): 过滤 CVE 的开始日期 (格式: YYYY-MM-DDTHH:MM:SS)
- end_date (可选): 过滤 CVE 的结束日期 (格式: YYYY-MM-DDTHH:MM:SS)
注意:
- 必须提供 cpe23 或 product 中的一个，但不能同时提供两者
- 日期过滤使用 CVE 的发布时间
返回:
- 查询信息
- 带有分页详情的结果摘要
- 包括以下内容的详细漏洞信息:
  - 基本信息
  - 严重程度评分
  - 影响评估
  - 参考资料

要求

Node.js (v18 或更高版本)
有效的 Shodan API Key

故障排除

API 密钥问题

如果您看到与 API 密钥相关的错误（例如，“请求失败，状态码 401”）：

验证您的 API 密钥：
- 必须是来自您的账户设置的有效 Shodan API 密钥
- 确保密钥有足够的积分/权限来执行该操作
- 检查配置中密钥周围是否有额外的空格或引号
- 确认 SHODAN_API_KEY 环境变量正确设置了密钥
常见错误代码：
- 401 未授权：无效的 API 密钥或缺少身份验证
- 402 需要支付：查询积分用尽
- 429 请求过多：超出速率限制

配置步骤： a. 从 Shodan 账户获取您的 API 密钥 b. 将其添加到您的配置文件中：

{
  "mcpServers": {
    "shodan": {
      "command": "mcp-shodan",
      "env": {
        "SHODAN_API_KEY": "your-actual-api-key-here"
      }
    }
  }
}

c. 保存配置文件 d. 重启 Claude Desktop

测试您的密钥：
- 先尝试一个简单的查询（例如，对 "google.com" 进行 dns_lookup）
- 在 Shodan 账户仪表板上检查积分状态
- 使用 curl 直接验证密钥是否有效：
```
curl "https://api.shodan.io/dns/resolve?hostnames=google.com&key=your-api-key"
```

模块加载问题

如果您遇到模块加载错误：

对于全局安装：使用快速入门中显示的简单配置
对于源码安装：确保您正在使用 Node.js v18 或更高版本

开发

要在开发模式下运行并启用热重载：

npm run dev

错误处理

服务器包括全面的错误处理功能，针对以下情况：

无效的 API 密钥
速率限制
网络错误
无效的输入参数
无效的 CVE 格式
无效的 CPE 查找参数
无效的日期格式
互斥参数验证

版本历史

v1.0.12: 添加了反向 DNS 查找并改进了输出格式
v1.0.7: 添加了按产品搜索 CVE 功能并将漏洞工具重命名为 cve_lookup
v1.0.6: 添加了 CVEDB 集成以增强 CVE 查找和 CPE 搜索功能
v1.0.0: 初始发布，包含核心功能

贡献

分叉仓库
创建一个特性分支 (git checkout -b feature/amazing-feature)
提交您的更改 (git commit -m 'Add amazing feature')
推送到分支 (git push origin feature/amazing-feature)
打开一个 Pull Request

许可证

此项目根据 MIT 许可证发布 - 详情请参阅 LICENSE 文件。

简介