Shodan MCP Server
2025.04.04
0
JavaScript网络服务API 网关数据查询搜索工具开发效率
Shodan MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，提供对 Shodan API 功能的访问，允许 AI 助手查询互联网连接设备和服务的相关信息。该服务具备查询主机信息、搜索设备和服务、扫描网络范围、获取 SSL 证书详情以及搜索特定类型的 IoT 设备等功能。
View on GitHub
Overview
基本能力
产品定位
Shodan MCP Server 是一个为 AI 助手提供互联网连接设备和服务信息查询能力的中间件服务。
核心功能
- 主机信息查询：获取特定 IP 地址的详细信息
- 搜索能力：在 Shodan 数据库中搜索设备和服务
- 网络扫描：扫描网络范围（CIDR 表示法）的设备
- SSL 证书信息：获取域名的 SSL 证书详情
- IoT 设备搜索：查找特定类型的 IoT 设备
适用场景
- 网络安全分析
- 设备监控
- 网络资产发现
- IoT 设备管理
工具列表
- get_host_info：获取特定 IP 地址的详细信息
- 参数：ip（必填）、max_items（可选）、fields（可选）
- search_shodan：在 Shodan 数据库中搜索设备和服务
- 参数：query（必填）、page（可选）、facets（可选）、max_items（可选）、fields（可选）、summarize（可选）
- scan_network_range：扫描网络范围（CIDR 表示法）的设备
- 参数：cidr（必填）、max_items（可选）、fields（可选）
- get_ssl_info：获取域名的 SSL 证书详情
- 参数：domain（必填）
- search_iot_devices：搜索特定类型的 IoT 设备
- 参数：device_type（必填）、country（可选）、max_items（可选）
常见问题解答
- 部分 Shodan API 端点需要付费会员才能使用
- 付费 API 密钥才能使用的功能包括：搜索功能、网络扫描、SSL 证书查找和 IoT 设备搜索
使用教程
使用依赖
- 确保已安装 Node.js 和 npm
安装教程
- 克隆仓库：
bash git clone https://github.com/Cyreslab-AI/shodan-mcp-server.git cd shodan-mcp-server - 安装依赖：
bash npm install - 构建服务器：
bash npm run build - 设置 Shodan API 密钥：
bash export SHODAN_API_KEY="your-api-key-here" - 启动服务器：
bash npm start
MCP 集成
- 将服务器添加到 MCP 设置中：
json { "mcpServers": { "shodan": { "command": "node", "args": ["/path/to/shodan-mcp-server/build/index.js"], "env": { "SHODAN_API_KEY": "your-api-key-here" } } } } - 重启 Claude 以加载新的 MCP 服务器
调试方式
- 确保服务器已正确启动并监听端口
- 检查 API 密钥是否正确设置
- 验证网络连接是否正常