Shodan MCP 服务器

一个提供对 Shodan API 功能访问的 Model Context Protocol (MCP) 服务器，允许 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 表示法
• max_items (可选): 数组中包含的最大项目数（默认值：5）
• fields (可选): 结果中要包含的字段列表

get_ssl_certificate

获取特定域 SSL 证书的信息。

参数:

• domain (必需): 要查询的域
• max_items (可选): 数组中包含的最大项目数（默认值：5）
• fields (可选): 结果中要包含的字段列表

search_iot_devices

查找特定类型的 IoT 设备。

参数:

• device_type (必需): 要搜索的设备类型
• vendor (可选): 设备的供应商
• model (可选): 设备的型号

资源

可用资源

• /api/host/<ip>：获取特定 IP 地址的主机信息
• /api/search：执行 Shodan 搜索查询
• /api/certificate：获取 SSL 证书信息
• /api/iot：搜索 IoT 设备

示例响应

查询主机信息

{
  "ip": "192.168.1.1",
  "hostname": "router.home",
  "ports": [80, 443],
  "protocols": ["http", "https"]
}

搜索结果

[
  {
    "ip": "10.0.0.1",
    "device_type": "router",
    "vendor": "Cisco"
  },
  {
    "ip": "10.0.0.2",
    "device_type": "camera",
    "vendor": "Axis"
  }
]

API 限制

• 每次调用的最多返回项数为 5
• 需要有效的 Shodan API 密钥才能进行身份验证
• 搜索功能可能受到速率限制

许可证

本项目遵循 MIT 许可证。请参阅 LICENSE 文件以获取详细信息。

贡献者

感谢所有贡献者！请查看 CONTRIBUTORS.md 以了解完整列表。

联系方式

如果有任何问题或反馈，请联系 support@cyberlabs.com。