Shodan MCP Server

Shodan MCP Server

標準化されたインターフェースを通じて、Shodan のインターネットスキャン機能にアクセスできる Model Context Protocol（MCP）サーバーです。

概要

このサーバーは Model Context Protocol を実装し、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
   • 戻り値：脆弱性に関する詳細情報

クエリの例

// Search for Log4j vulnerable systems in the US
{
  "query": "log4j country:US"
}

// DNS lookup for a domain
{
  "query": "example.com"
}

// Get CVE information
{
  "query": "CVE-2021-44228"
}

MCP Inspector の使用

MCP Inspector を使用すると、サーバーと直接やり取りできます：

1. MCP Inspector をインストールします：

npm install -g @modelcontextprotocol/inspector

2. サーバーを指定して Inspector を実行します：

npx @modelcontextprotocol/inspector build/index.js

Inspector では、次の操作を行えるインタラクティブなインターフェースが提供されます：

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

環境変数

• SHODAN_API_KEY：Shodan API キー（必須）
• PORT：サーバーのポート（任意。デフォルトは 3000）
• LOG_LEVEL：ログレベル（任意。デフォルトは 'info'）

エラー処理

サーバーは、次のエラーを包括的に処理します：

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

セキュリティ上の考慮事項

1. API キーの保護：

   • API キーをバージョン管理にコミットしないでください
   • 機密データには環境変数を使用してください
   • API キーを定期的にローテーションしてください

2. レート制限：

   • Shodan の API レート制限を遵守してください
   • クライアント側でレート制限を実装してください

3. データプライバシー：

   • 応答から機密情報を除外してください
   • 必要に応じてアクセス制御を実装してください

ライセンス

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

謝辞

• API を提供している Shodan
• MCP 仕様を策定した Model Context Protocol チーム