Zoomeye MCP Server

Zoomeye MCP サーバー

ZoomEye v2 API へのアクセスを提供する MCP（Model Context Protocol）サーバーです。AI アシスタントがインターネット全体のホストデータやウェブデータを検索し、アカウントの利用枠を確認できるほか、有料プランでは IP 履歴を取得できます。

機能

• ホスト検索：IP、ポート、サービスなどでデバイスを検索します。
• ウェブ検索：ウェブに公開されているアプリケーションやコンポーネントをインデックス化します。
• アカウント情報：ZoomEye のプランと、残りの検索回数を確認します。
• 結果のサンプリング：レスポンスのサイズを制限し、必要なフィールドのみを選択します。
• 要約：上位の国、ポート、組織の要約を自動生成します。
• （有料）IP 履歴：指定した IP の過去のスキャンデータを取得します。

要件

• Node.js ≥ 16
• ZoomEye API キー（https://www.zoomeye.org/profile で確認できます）
• https://api.zoomeye.org へのインターネットアクセス

インストール

1. リポジトリをクローンします。

   git clone https://github.com/help116114/zoomeye-mcp-server.git
   cd zoomeye-mcp-server
   

2. 依存関係をインストールします。

   npm install
   

3. サーバーをビルドします。

   npm run build
   

4. Zoomeye API キーを設定します。

   export Zoomeye_API_KEY="your-api-key-here"
   

5. サーバーを起動します。

   npm start
   

MCP との統合

このサーバーは、MCP 互換の AI LLM と統合できます。Cline、Curser、または Claude に追加するには、次の手順に従います。

1. MCP の設定にサーバーを追加します。

   {
     "mcpServers": {
       "zoomeye": {
         "command": "node",
         "args": ["./build/index.js"],
         "env": {
           "ZOOMEYE_API_KEY": "your-api-key-here"
         }
       }
     }
   }
   

2. 新しい MCP サーバーを再読み込みします。

利用可能なツール

get_account_info

特定の IP アドレスに関する詳細情報を取得します。

パラメーター：

• ip（必須）：検索する IP アドレス
• max_items（任意）：配列に含める項目の最大数（デフォルト：5）
• fields（任意）：結果に含めるフィールドのリスト（例：['ip_str', 'ports', 'location.country_name']）

search_host

デバイスやサービスをホスト側から検索します。

パラメーター：

• query（必須）：Shodan 検索クエリ（例：'apache country:US'）
• page（任意）：結果をページ分割する際のページ番号（デフォルト：1）
• facets（任意）：検索結果に含めるファセットのリスト（例：['country', 'org']）
• max_items（任意）：配列に含める項目の最大数（デフォルト：5）
• fields（任意）：結果に含めるフィールドのリスト（例：['ip_str', 'ports', 'location.country_name']）
• summarize（任意）：すべてのデータの代わりに結果の要約を返すかどうか（デフォルト：false）

search_web

ZoomEye データベース内のウェブリソースを検索します。

パラメーター：

• query（必須）：Shodan 検索クエリ（例：'apache country:US'）
• page（任意）：結果をページ分割する際のページ番号（デフォルト：1）
• facets（任意）：検索結果に含めるファセットのリスト（例：['country', 'org']）

get_history_ip

（有料）IP の過去のスキャンデータを取得します。

パラメーター：

• ip（必須）：過去のスキャンデータを取得する IP アドレス（例：ip="8.8.8.8"）

summarize

上位の国、ポート、組織の要約を生成します。

パラメーター：

• device_type（必須）：検索する IoT デバイスの種類（例：'webcam'、'router'、'smart tv'）
• country（任意）：検索対象を絞り込む国コード（例：'US'、'DE'）
• max_items（任意）：結果に含める項目の最大数（デフォルト：5）

利用可能なリソース

• zoomeye://host/{ip}：特定の IP アドレスに関する情報

API の制限

Zoomeye API の一部のエンドポイントを利用するには、有料メンバーシップが必要です。以下の機能は、有料の Zoomeye API キーでのみ利用できます。

• 有料プラン向けの追加機能
• 検索機能
• ネットワークスキャン
• SSL 証明書の検索
• IoT デバイスの検索

上記の手順に従うと、zoomeye‑mcp‑server を MCP 互換のクライアントにシームレスに組み込み、AI アシスタントから ZoomEye の強力なサイバースペース検索機能へリアルタイムにアクセスできるようになります。

ライセンス

ZGCLAB

開発者

NASP