Shodan MCP Server Inspector

🚀 Shodan MCP サーバー

Model Context Protocol (MCP) を実装したサーバーで、標準化されたインターフェースを通じて Shodan のインターネットスキャン機能へのアクセスを提供します。

🚀 クイックスタート

このサーバーは、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
   • 返却値：詳細な脆弱性情報

クエリ例

// 米国にある Log4j 脆弱性のあるシステムを検索
{
  "query": "log4j country:US"
}

// ドメイン名を解析
{
  "query": "example.com"
}

// CVE 情報を取得
{
  "query": "CVE-2021-44228"
}

MCP チェックツールの使用

MCP チェックツールを使用してサーバーと直接やり取りすることができます。

1. MCP チェックツールをインストールします：

npm install -g @modelcontextprotocol/inspector

2. チェックツールを使用してサーバーに接続します：

npx @modelcontextprotocol/inspector build/index.js

チェックツールは以下の機能を提供します：

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

⚠️ 重要提示

API キーの安全性を確保し、漏洩を防いでください。

💡 使用建议

本番環境で使用する前に、すべての機能をテストしてください。問題が発生した場合は、公式ドキュメントを参照するか、サポートチームに連絡してください。