mcpField
M
mcp-shodan

mcp-shodan

本地服务
github.com/daedalus安全127 周前更新
代码仓库

关于 mcp-shodan

mcp-shodan 面向安全分析人员及其他 MCP 客户端，提供 Shodan API 操作。工具覆盖主机查询、数据库搜索、警报、扫描、保存的查询、漏洞利用信息和 API 实用信息。

主要功能

  1. 01查询 IP 主机信息
  2. 02搜索 Shodan 并统计结果
  3. 03管理警报与网络扫描
  4. 04查找保存的查询和查询标签
  5. 05搜索 Shodan Exploits 档案
  6. 06查看 API、端口、协议和服务信息

适用场景

  1. 01查询 IP 地址暴露的服务
  2. 02搜索或统计符合条件的主机
  3. 03创建警报或查看扫描状态
  4. 04搜索已保存的查询或漏洞利用记录

MCP 相关

该 MCP 服务将 Shodan API 功能作为工具提供给 MCP 客户端，包括主机信息、搜索、警报、扫描、保存的查询和漏洞利用查询。它需要 Shodan API 密钥。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "daedalus-mcp-shodan": {
      "command": "uvx",
      "args": [
        "mcp-shodan"
      ]
    }
  }
}
启动命令uvx mcp-shodan

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypimcp-shodan0.1.0

工具

20

收录的工具列表 · 更新于 2 周前

参数类型必填说明
ipstring是计算机的 IP 地址。
minifyboolean否设为 True 时，仅返回端口列表和主机的一般信息。
historyboolean否设为 True 时，获取主机的历史 banner。

详细介绍

mcp-shodan

通过模型上下文协议提供 Shodan API 功能的 MCP 服务。

PyPI Python Coverage Ruff

安装

pip install mcp-shodan

使用方法

export SHODAN_API_KEY=your_api_key
mcp-shodan

或者添加到 MCP 配置中：

{
  "mcpServers": {
    "shodan": {
      "command": "mcp-shodan",
      "env": {
        "SHODAN_API_KEY": "your_api_key"
      }
    }
  }
}

可用工具

主机信息
  • shodan_host - 获取 IP 地址的所有可用信息
搜索
  • shodan_search - 搜索 Shodan 数据库
  • shodan_search_cursor - 搜索并返回迭代器
  • shodan_count - 获取搜索结果总数
  • shodan_search_tokens - 获取搜索查询的信息
警报
  • shodan_alerts - 列出所有活动警报
  • shodan_create_alert - 创建新警报
  • shodan_delete_alert - 删除警报
扫描
  • shodan_scan - 扫描网络
  • shodan_scan_internet - 扫描互联网中的指定端口
  • shodan_scan_status - 获取扫描状态
已保存的查询
  • shodan_queries - 列出共享搜索查询
  • shodan_queries_search - 搜索已保存的查询
  • shodan_queries_tags - 获取热门查询标签
漏洞利用
  • shodan_exploits_search - 搜索 Shodan 漏洞利用档案
  • shodan_exploits_count - 获取漏洞利用总数
实用工具
  • shodan_info - 获取 API 密钥信息
  • shodan_ports - 获取 Shodan 爬取的端口列表
  • shodan_protocols - 获取支持的协议
  • shodan_services - 获取服务列表

示例

# Get information about a host
shodan_host("1.1.1.1")

# Search for specific services
shodan_search("apache", limit=10)

# Count results for a query
shodan_count("nginx")

# Check your API plan
shodan_info()

mcp-name: io.github.daedalus/mcp-shodan

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。