JinDaGe - Cyreslab-AI_shodan-mcp-server MCP Details

article

README

🚀 Shodan MCP 服务器

Shodan MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，它提供了对 Shodan API 功能的访问，让 AI 助手能够查询互联网连接设备和服务的详细信息，为网络信息查询提供了便捷的途径。

✨ 主要特性

主机信息：可精准获取特定 IP 地址的详细信息。
搜索功能：能够在 Shodan 数据库中高效搜索设备和服务。
网络扫描：支持扫描网络范围（CIDR 格式），从而查找网络中的设备。
SSL 证书信息：可获取域 SSL 证书的详细信息。
IoT 设备搜索：能查找特定类型的 IoT 设备。

📦 安装指南

克隆仓库：

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

安装依赖项：
```
npm install
```
构建服务器：
```
npm run build
```

设置你的 Shodan API 密钥：

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

启动服务器：
```
npm start
```

📚 详细文档

MCP 集成

此服务器可与 Claude 或其他兼容 MCP 的 AI 助手集成。若要将其添加到 Claude Desktop 或 Claude.app 中，可按以下步骤操作：

将服务器添加到你的 MCP 设置中：

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

重启 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。

Cyreslab-AI_shodan-mcp-server