Zoomeye MCP Server

🚀 ZoomEye MCP サーバー

ZoomEye v2 API へのアクセスを提供する MCP（モデルコンテキストプロトコル）サーバーです。これにより、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 アドレス（必須）。

応答例:

{
  "status": "success",
  "data": {
    "ip": "192.168.1.1",
    "hostname": "example.com",
    "geolocation": {
      "country": "中国",
      "city": "北京"
    },
    "ports": ["80", "443"]
  }
}

search_host

IP またはドメイン名を使ってホスト情報を検索します。 パラメータ:

• query: 検索する IP アドレスまたはドメイン名（必須）。
• max_items: 返す最大アイテム数（オプション、デフォルトは 10）。

get_ip_history

特定の IP の過去のスキャンデータを取得します。 パラメータ:

• ip: 特定の IP アドレス（必須）。

リソース

zoomeye://host/{ip}：照会するホストリソースを表します。

API 制限

• 無料プラン: 1 時間あたり 100 回のリクエストが制限されています。
• 有料プラン: より高いクォータとより多くの高度な機能が提供されます。

📄 ライセンス

ZGCLAB

開発者

NASP