Shodan Fast Mcp Server

Shodan MCP 服务

一款完全异步、达到生产级标准的 MCP 服务，可将完整的 Shodan API（REST、Streaming 和 Trends）作为 MCP 工具提供。该服务基于 Python、httpx 和 MCP Python SDK 构建，可将 Shodan 强大的互联网情报工具无缝集成到自动化、研究和安全工作流中。

功能

• 全面覆盖 Shodan API：
  • REST API：主机信息、搜索、DNS、数据集、账户、工具等
  • Streaming API：实时数据流、端口和警报事件流
  • Trends API：针对任意查询的热门端口、组织和国家
• 异步且高性能：
  • 基于 httpx 和 async/await 构建，实现最高并发能力和速度
• 安全认证：
  • 从环境变量中读取各 API 类型对应的 API 密钥
• 轻松集成：
  • 可与 Claude Desktop、CLI 或任何兼容 MCP 的客户端搭配使用

环境变量

运行服务前，请将 Shodan API 凭据设置为环境变量：

• SHODAN_API_KEY（所有 API 的默认密钥）
• SHODAN_STREAM_API_KEY（可选，用于 Streaming API）
• SHODAN_TRENDS_API_KEY（可选，用于 Trends API）

如果未设置特定密钥，服务将回退使用 SHODAN_API_KEY。

使用方法

1. 安装依赖项

    uv add "mcp[cli]"
    uv add "sseclient-py"

2. 设置环境变量

export SHODAN_API_KEY=your_main_shodan_api_key
# Optionally:
export SHODAN_STREAM_API_KEY=your_streaming_key
export SHODAN_TRENDS_API_KEY=your_trends_key

3. 启动服务（使用 uvicorn 或 uv）

uv --directory /Users/haji/mcp-servers/shodan-mcp run server.py

4. Claude Desktop 的 MCP 服务配置

将以下内容保存为 .json 文件，并在 Claude Desktop 或 Cursor 中加载：

{
  "mcpServers": {
    "ShodanMCP": {
      "command": "uv",
      "args": [
        "--directory", "/Users/haji/mcp-servers/shodan-mcp",
        "run", "server.py"
      ]
    }
  }
}

影响与使用场景

• 安全研究： 即时查询 Shodan 全球互联网情报，用于威胁搜寻、资产发现和漏洞研究。
• 自动化： 通过 MCP 将 Shodan 工具集成到安全管道、SIEM 或自定义仪表板中。
• 实时监控： 实时传输横幅信息和警报，以主动监控基础设施或开放互联网。
• 数据科学： 利用 Shodan Trends API 分析、报告和可视化全球互联网趋势。

致谢

• Shodan — 全球领先的联网设备搜索引擎。

---

© 2024 Haji 和贡献者。本项目与 Shodan 无关。将 Shodan 数据用于商业用途时，请确保遵守 Shodan 服务条款。