Cyreslab AI Shodan MCP Server

🚀 Shodan MCP サーバー

このサーバーは、Shodan API 機能へのアクセスを提供する Model Context Protocol (MCP) サーバーです。AI アシスタントがインターネット接続機器やサービスの情報を照会できるようになります。

🚀 クイックスタート

この Shodan MCP サーバーを使用することで、AI アシスタントは Shodan API を通じてインターネット接続機器やサービスの情報を取得できます。以下に、サーバーのセットアップ手順や使用方法を説明します。

✨ 主な機能

• ホスト情報：特定の 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. Claude を再起動して、新しい MCP サーバーを読み込みます。

利用可能なツール

get_host_info

特定の IP アドレスの詳細情報を取得します。 パラメーター:

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

search_shodan

Shodan データベース内で機器やサービスを検索します。 パラメーター:

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

scan_network_range

ネットワーク範囲（CIDR 形式）をスキャンして機器を探します。 パラメーター:

• cidr (必須): ネットワーク範囲の CIDR 表記
• max_items (オプション): 配列に含める最大項目数（デフォルト: 5）
• fields (オプション): 結果に含めるフィールドのリスト

get_ssl_certificate

特定のドメインの SSL 証明書の情報を取得します。 パラメーター:

• domain (必須): 照会するドメイン
• max_items (オプション): 配列に含める最大項目数（デフォルト: 5）
• fields (オプション): 結果に含めるフィールドのリスト

search_iot_devices

特定のタイプの IoT 機器を検索します。 パラメーター:

• device_type (必須): 検索する機器のタイプ
• vendor (オプション): 機器のベンダー
• model (オプション): 機器のモデル

利用可能なリソース

• /api/host/<ip>：特定の IP アドレスのホスト情報を取得します。
• /api/search：Shodan 検索クエリを実行します。
• /api/certificate：SSL 証明書の情報を取得します。
• /api/iot：IoT 機器を検索します。

応答例

ホスト情報の照会

{
  "ip": "192.168.1.1",
  "hostname": "router.home",
  "ports": [80, 443],
  "protocols": ["http", "https"]
}

検索結果

[
  {
    "ip": "10.0.0.1",
    "device_type": "router",
    "vendor": "Cisco"
  },
  {
    "ip": "10.0.0.2",
    "device_type": "camera",
    "vendor": "Axis"
  }
]

API 制限

• 1 回の呼び出しでの最大返却項目数は 5 です。
• 有効な Shodan API キーが必要です。
• 検索機能はレート制限の対象となる場合があります。

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいています。詳細については LICENSE ファイルを参照してください。

貢献者

すべての貢献者に感謝します！完全なリストについては CONTRIBUTORS.md を参照してください。

連絡先

何か質問やフィードバックがある場合は、support@cyberlabs.com までご連絡ください。