Shodan MCP Server

Shodan MCP 服务器

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

特征

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

安装

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