JinDaGe - Shodan MCP Server MCP Details

article

README

🚀 Shodan MCP 服务器

Shodan MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，它提供了对 Shodan API 功能的访问。借助该服务器，AI 助手能够轻松查询互联网连接设备和服务的相关信息，为信息获取提供了极大的便利。

🚀 快速开始

此服务器能让 AI 助手查询互联网连接设备和服务的信息。按以下步骤操作，即可轻松开启使用之旅。

✨ 主要特性

主机信息：可获取特定 IP 地址的详细信息。
搜索功能：支持在 Shodan 数据库中搜索设备和服务。
网络扫描：能扫描网络范围（CIDR 格式）以查找设备。
SSL 证书信息：可获取域 SSL 证书的详细信息。
物联网设备搜索：能够查找特定类型的 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 搜索查询（例如，"web server"）
page（可选）：结果页码
limit（可选）：每页的结果数量

scan_network

扫描网络范围以查找设备。 参数：

cidr（必需）：要扫描的 CIDR 范围（例如，"192.168.1.0/24"）

get_ssl_certificate

获取域 SSL 证书的详细信息。 参数：

domain（必需）：要查找的域名

search_iot_devices

查找特定类型的 IoT 设备。 参数：

device_type（可选）：设备类型过滤器
vendor（可选）：设备供应商过滤器

资源

特定资源可以通过以下 URL 访问：

https://api.shodan.io/labs/[resource]

API 限制

免费 API：提供基本功能，有速率限制。
付费 API：提供更多高级功能和更高的请求限制。

📄 许可证

项目使用 MIT 许可证。

开发者信息

由 [Your Name] 开发。

Shodan MCP Server