Shodan MCP Server

Shodan MCP Server

site icon
2025.04.03 1
JavaScript网络扫描设备查询安全分析搜索工具开发效率
Shodan MCP Server 是一个基于模型上下文协议(MCP)的服务,提供对Shodan API功能的访问,使AI助手能够查询互联网连接设备和服务的相关信息。该服务具备查询主机信息、搜索Shodan数据库、扫描网络范围、获取SSL证书信息以及搜索IoT设备等核心功能。
View on GitHub

Overview

基本能力

产品定位

Shodan MCP Server 是一个为AI助手提供互联网连接设备和服务信息查询能力的中间件服务。

核心功能

  • 主机信息查询:获取特定IP地址的详细信息
  • 搜索能力:搜索Shodan数据库中的设备和服务
  • 网络扫描:扫描网络范围(CIDR表示法)中的设备
  • SSL证书信息:获取域名的SSL证书详细信息
  • IoT设备搜索:查找特定类型的IoT设备

适用场景

  • 网络安全分析
  • 设备监控
  • 网络资产发现
  • IoT设备追踪
  • 安全研究

工具列表

  1. get_host_info:获取特定IP地址的详细信息
  2. search_shodan:搜索Shodan数据库中的设备和服务
  3. scan_network_range:扫描网络范围中的设备
  4. get_ssl_info:获取域名的SSL证书信息
  5. search_iot_devices:搜索特定类型的IoT设备

常见问题解答

  • 部分Shodan API端点需要付费会员资格才能使用
  • 搜索功能、网络扫描、SSL证书查找和IoT设备搜索等功能需要付费Shodan API密钥

使用教程

使用依赖

  1. 需要安装Node.js环境
  2. 需要有效的Shodan API密钥

安装教程

  1. 克隆仓库: bash git clone https://github.com/Cyreslab-AI/shodan-mcp-server.git cd shodan-mcp-server
  2. 安装依赖: bash npm install
  3. 构建服务器: bash npm run build
  4. 设置Shodan API密钥: bash export SHODAN_API_KEY="your-api-key-here"
  5. 启动服务器: bash npm start

调试方式

  1. 检查服务器是否正常运行
  2. 使用提供的工具进行测试查询
  3. 检查API密钥是否正确设置
  4. 查看日志输出以排查问题

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。