Shodan MCP 服务器

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

特征

• 主机信息：获取特定 IP 地址的详细信息

• 搜索功能：在 Shodan 数据库中搜索设备和服务

• 网络扫描：扫描设备的网络范围（CIDR 表示法）

• SSL 证书信息：获取域名的 SSL 证书详细信息

• 物联网设备搜索：查找特定类型的物联网设备

Related MCP server: Shodan MCP Server

安装

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 服务器。

可用工具

获取主机信息

获取有关特定 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）

扫描网络范围

扫描设备的网络范围（CIDR 表示法）。

参数：

• cidr （必需）：CIDR 表示法的网络范围（例如 192.168.1.0/24）

• max_items （可选）：结果中包含的最大项目数（默认值：5）

• fields （可选）：结果中包含的字段列表（例如，['ip_str'、'ports'、'location.country_name']）

获取 SSL 信息

获取域的 SSL 证书信息。

参数：

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

搜索物联网设备

搜索特定类型的物联网设备。

参数：

• device_type （必需）：要搜索的物联网设备类型（例如“网络摄像头”、“路由器”、“智能电视”）

• country （可选）：可选国家代码以限制搜索（例如“美国”、“德国”）

• max_items （可选）：结果中包含的最大项目数（默认值：5）

可用资源

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

API 限制

部分 Shodan API 端点需要付费会员资格。以下功能仅需付费 Shodan API 密钥即可使用：

• 搜索功能

• 网络扫描

• SSL 证书查找

• 物联网设备搜索

执照

麻省理工学院

开发者

Cyreslab.ai