Shodan Fast Mcp Server

Shodan MCP サーバー

Shodan API（REST、Streaming、Trends）の全機能をMCPツールとして公開する、完全非同期で本番運用に適した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 & Contributors。このプロジェクトはShodanと提携していません。Shodanのデータを商用利用する場合は、Shodanの利用規約を遵守してください。