Shodan MCP Server

Shodan MCP サーバー

Shodan API 機能へのアクセスを提供し、AI アシスタントがインターネットに接続されたデバイスやサービスに関する情報を照会できるようにするモデル コンテキスト プロトコル (MCP) サーバー。

特徴

• ホスト情報: 特定のIPアドレスに関する詳細情報を取得します
• 検索機能: Shodanのデータベースでデバイスとサービスを検索
• ネットワークスキャン: デバイスのネットワーク範囲(CIDR表記)をスキャンします
• SSL証明書情報:ドメインのSSL証明書の詳細を取得します
• IoTデバイス検索: 特定の種類のIoTデバイスを検索

インストール

1. リポジトリをクローンします。
   git clone https://github.com/Cyreslab-AI/shodan-mcp-server.git cd shodan-mcp-server
2. 依存関係をインストールします:
   npm install
3. サーバーを構築します。
   npm run build
4. Shodan API キーを設定します。
   export SHODAN_API_KEY="your-api-key-here"
5. サーバーを起動します。
   npm start

MCP統合

このサーバーは、Claude やその他の MCP 対応 AI アシスタントと統合できます。Claude Desktop または Claude.app に追加するには、以下の手順に従ってください。

1. MCP 設定にサーバーを追加します。
   { "mcpServers": { "shodan": { "command": "node", "args": ["/path/to/shodan-mcp-server/build/index.js"], "env": { "SHODAN_API_KEY": "your-api-key-here" } } } }
2. 新しい MCP サーバーをロードするには、Claude を再起動します。

利用可能なツール

ホスト情報を取得する

特定の IP アドレスに関する詳細情報を取得します。

パラメータ:

• ip (必須): 検索するIPアドレス
• max_items (オプション): 配列に含めるアイテムの最大数 (デフォルト: 5)
• fields (オプション): 結果に含めるフィールドのリスト (例: ['ip_str', 'ports', 'location.country_name'])

検索_shodan

Shodan のデータベースでデバイスとサービスを検索します。

パラメータ:

• query （必須）: Shodan 検索クエリ（例: 'apache country'）
• page (オプション): 結果のページ番号 (デフォルト: 1)
• facets （オプション）：検索結果に含めるファセットのリスト（例：['country', 'org']）
• max_items (オプション): 配列に含めるアイテムの最大数 (デフォルト: 5)
• fields (オプション): 結果に含めるフィールドのリスト (例: ['ip_str', 'ports', 'location.country_name'])
• summarize （オプション）：完全なデータではなく結果の要約を返すかどうか（デフォルト：false）

スキャンネットワーク範囲

デバイスのネットワーク範囲 (CIDR 表記) をスキャンします。

パラメータ:

• cidr (必須): CIDR表記のネットワーク範囲 (例: 192.168.1.0/24)
• max_items （オプション）：結果に含めるアイテムの最大数（デフォルト：5）
• fields (オプション): 結果に含めるフィールドのリスト (例: ['ip_str', 'ports', 'location.country_name'])

取得SSL情報

ドメインの SSL 証明書情報を取得します。

パラメータ:

• domain （必須）: SSL証明書を検索するドメイン名（例：example.com）

IoTデバイス検索

特定の種類の IoT デバイスを検索します。

パラメータ:

• device_type (必須): 検索する IoT デバイスの種類 (例: 「ウェブカメラ」、「ルーター」、「スマートテレビ」)
• country （オプション）: 検索を限定するための国コード（例：'US'、'DE'）
• max_items （オプション）：結果に含めるアイテムの最大数（デフォルト：5）

利用可能なリソース

• shodan://host/{ip} : 特定のIPアドレスに関する情報

APIの制限

一部のShodan APIエンドポイントは有料メンバーシップが必要です。以下の機能は有料のShodan APIキーでのみご利用いただけます。

• 検索機能
• ネットワークスキャン
• SSL証明書の検索
• IoTデバイス検索

ライセンス

マサチューセッツ工科大学

開発者

Cyreslab.ai