Shodan MCP Server

🚀 Shodan MCP 服务器

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

🚀 快速开始

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

✨ 主要特性

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