Shodan MCP Server

🚀 Shodan MCP サーバー

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

✨ 主な機能

• ホスト情報：特定の 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 検索クエリ（例："web server"）
• page（オプション）：結果のページ番号
• limit（オプション）：1 ページあたりの結果数

scan_network

ネットワーク範囲をスキャンしてデバイスを探します。

パラメーター：

• cidr（必須）：スキャンする CIDR 範囲（例："192.168.1.0/24"）

get_ssl_certificate

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

パラメーター：

• domain（必須）：検索するドメイン名

search_iot_devices

特定のタイプの IoT デバイスを探します。

パラメーター：

• device_type（オプション）：デバイスタイプのフィルター
• vendor（オプション）：デバイスベンダーのフィルター

📚 ドキュメント

特定のリソースは、以下の URL からアクセスできます。

https://api.shodan.io/labs/[resource]

⚠️ API 制限

• 無料 API：基本機能を提供し、レート制限があります。
• 有料 API：より高度な機能とより高いリクエスト制限を提供します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。

👨‍💻 開発者情報

[Your Name] によって開発されました。