基本能力
产品定位
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 密钥是否正确设置
- 验证网络连接是否正常