Shodan MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供对 Shodan API 功能的访问，允许 AI 助手查询有关互联网连接的设备和服务的信息。

功能

• 主机信息: 获取有关特定 IP 地址的详细信息
• 搜索功能: 在 Shodan 数据库中搜索设备和服务
• 网络扫描: 扫描网络范围（CIDR 表示法）以查找设备
• SSL 证书信息: 获取域名的 SSL 证书详细信息
• IoT 设备搜索: 查找特定类型的 IoT 设备

安装

1. 克隆存储库:

   git clone https://github.com/Cyreslab-AI/shodan-mcp-server.git
   cd shodan-mcp-server
   

2. 安装依赖项:

   npm install
   

3. 构建服务器:

   npm run build
   

4. 设置您的 Shodan API 密钥:

   export SHODAN_API_KEY="your-api-key-here"
   

5. 启动服务器:

   npm start
   

MCP 集成

此服务器可以与 Claude 或其他 MCP 兼容的 AI 助手集成。 要将其添加到 Claude Desktop 或 Claude.app：

1. 将服务器添加到您的 MCP 设置：

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

2. 重新启动 Claude 以加载新的 MCP 服务器。

可用工具

get_host_info

获取有关特定 IP 地址的详细信息。

参数：

• ip (必需): 要查找的 IP 地址
• max_items (可选): 数组中包含的最大项目数（默认值：5）
• fields (可选): 结果中包含的字段列表（例如，['ip_str', 'ports', 'location.country_name']）

search_shodan

在 Shodan 数据库中搜索设备和服务。

参数：

• query (必需): Shodan 搜索查询（例如，'apache country:US'）
• page (可选): 结果分页的页码（默认值：1）
• facets (可选): 搜索结果中包含的方面列表（例如，['country', 'org']）
• max_items (可选): 数组中包含的最大项目数（默认值：5）
• fields (可选): 结果中包含的字段列表（例如，['ip_str', 'ports', 'location.country_name']）
• summarize (可选): 是否返回结果的摘要而不是完整数据（默认值：false）

scan_network_range

扫描网络范围（CIDR 表示法）以查找设备。

参数：

• cidr (必需): CIDR 表示法中的网络范围（例如，192.168.1.0/24）
• max_items (可选): 结果中包含的最大项目数（默认值：5）
• fields (可选): 结果中包含的字段列表（例如，['ip_str', 'ports', 'location.country_name']）

get_ssl_info

获取域名的 SSL 证书信息。

参数：

• domain (必需): 要查找 SSL 证书的域名（例如，example.com）

search_iot_devices

搜索特定类型的 IoT 设备。

参数：

• device_type (必需): 要搜索的 IoT 设备类型（例如，'webcam'、'router'、'smart tv'）
• country (可选): 用于限制搜索的可选国家/地区代码（例如，'US'、'DE'）
• max_items (可选): 结果中包含的最大项目数（默认值：5）

可用资源

• shodan://host/{ip}: 有关特定 IP 地址的信息

API 限制

某些 Shodan API 端点需要付费会员资格。 以下功能仅适用于付费 Shodan API 密钥：

• 搜索功能
• 网络扫描
• SSL 证书查找
• IoT 设备搜索

许可证

MIT

开发人员

Cyreslab.ai