Shodan MCP サーバー

標準化されたインターフェースを通じて Shodan のインターネット スキャン機能へのアクセスを提供するモデル コンテキスト プロトコル (MCP) サーバー。

概要

このサーバーは、Shodanの強力なインターネットスキャンおよび偵察機能を公開するために、モデルコンテキストプロトコルを実装しています。インターネットに接続されたデバイス、サービス、および脆弱性に関するShodanのデータベースにクエリを実行するための標準化されたインターフェースを提供します。

特徴

• 検索機能: 高度な検索フィルターを使用してShodanのデータベースを照会します
• DNSルックアップ:ドメイン名を解決し、詳細なDNS情報を取得します
• CVE情報: 共通脆弱性識別子(CVE)に関する詳細情報を取得します
• 脆弱性情報を取得: IPアドレスに関連する脆弱性の詳細情報を取得します
• 標準化されたインターフェース: 一貫した通信のためにMCPプロトコルを使用
• 環境変数のサポート: 環境変数による安全な API キー管理

前提条件

• Node.js (v14以上)
• npm (v6以上)
• Shodan APIキー

インストール

1. リポジトリをクローンします。
   git clone https://github.com/X3r0K/Shodan-MCP-Server-Inspector.git cd shodan-mcp-server-Inspector
2. 依存関係をインストールします:
   npm install
3. ルート ディレクトリに.env.localファイルを作成し、Shodan API キーを追加します。
   SHODAN_API_KEY=your_api_key_here

使用法

サーバーの起動

1. サーバーを構築します。
   npm run build
2. サーバーを起動します。
   node build/index.js

利用可能なツール

1. 検索ツール
   • クエリ: Shodanの検索構文を使用してデバイスとサービスを検索します
   • 例: log4j country:US city:Atlanta
   • 戻り値: 詳細情報を含む一致するデバイスのリスト
2. DNSルックアップツール
   • クエリ: 解決するドメイン名
   • 例: example.com
   • 返されるもの: DNSレコードと関連情報
3. CVE情報ツール
   • クエリ: CVE識別子
   • 例: CVE-2021-44228
   • 戻り値: 詳細な脆弱性情報

クエリの例

MCPインスペクターの使用

MCP インスペクターを使用すると、サーバーと直接対話することができます。

1. MCP インスペクターをインストールします。

2. サーバーでインスペクターを実行します。

インスペクターは、次の操作を行うための対話型インターフェースを提供します。

• 利用可能なすべてのツールをテストする
• ツールのドキュメントを見る
• サーバーの応答をデバッグする
• サーバーの状態を監視する

環境変数

• SHODAN_API_KEY : Shodan APIキー（必須）
• PORT : サーバーポート（オプション、デフォルトは3000）
• LOG_LEVEL : ログレベル（オプション、デフォルトは「info」）

エラー処理

サーバーは、以下に対する包括的なエラー処理を実装します。

• 無効なAPIキー
• レート制限
• ネットワークの問題
• 無効なクエリ
• サーバーエラー

セキュリティに関する考慮事項

1. APIキーの保護:
   • APIキーをバージョン管理にコミットしない
   • 機密データには環境変数を使用する
   • APIキーを定期的にローテーションする
2. レート制限:
   • ShodanのAPIレート制限を尊重する
   • クライアント側のレート制限を実装する
3. データプライバシー:
   • 回答から機密情報をフィルタリングする
   • 必要に応じてアクセス制御を実装する

ライセンス

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

謝辞

• APIを提供してくれたShodan
• MCP仕様のモデルコンテキストプロトコルチーム