MCP Zoomeye

🚀 ZoomEye MCP サーバーガイド

ZoomEye MCP サーバーは、ZoomEye API を利用したデータ検索や管理を行うためのサーバーです。このガイドでは、サーバーのインストール、設定、使用方法、高度な機能、貢献方法などについて説明します。

🚀 クイックスタート

🔍 インストール

ZoomEye MCP サーバーを npm を使ってインストールします。

npm install -g mcp-server-zoomeye

インストールが完了したら、以下のコマンドで起動できます。

mcp-server-zoomeye --help

⚙️ 環境変数の設定

ZoomEye API への正常なアクセスを確保するために、ZOOM_EYE_API_KEY 環境変数を設定します。

Unix/MacOS

export ZOOM_EYE_API_KEY='your_api_key_here'

Windows

set ZOOM_EYE_API_KEY=your_api_key_here

🚀 サーバーの起動

サーバーを指定のポート（デフォルトは 3000）にバインドして起動します。

mcp-server-zoomeye --port 3000

💻 使用例

🔍 ZoomEye データの検索

http://localhost:3000/mcp に POST リクエストを送信します。リクエストボディは以下の通りです。

{
  "name": "zoomeye_search",
  "arguments": {
    "qbase64": "app=\"Apache\"",
    "page": 1,
    "pagesize": 50
  }
}

📋 応答例

{
  "id": "unique requestId",
  "status": "success",
  "result": {
    "data": [
      // 返される結果データの配列
    ],
    "total": 100,
    "page": 1,
    "pagesize": 50
  }
}

🛠️ デバッグとトラブルシューティング

🧐 MCP チェッカーの使用

ZoomEye MCP サーバーをチェックします。

npx @modelcontextprotocol/inspector uvx mcp-server-zoomeye

ローカル開発時には以下のコマンドを使用します。

cd path/to/servers/src/mcp_server_zoomeye
npx @modelcontextprotocol/inspector uv run mcp-server-zoomeye

❓ 一般的な問題と解決策

🔑 認証エラー

• ZoomEye API キーが正しく設定されていることを確認してください。
• キーが期限切れまたは無効になっていないことを確認してください。

🌐 接続問題

• ネットワーク接続を確認してください。
• ZoomEye API が正常に動作していることを確認してください。

📊 結果がない場合

• クエリが過度に具体的であるか、構文エラーがある可能性があります。
• クエリを簡素化するか、別の検索語を試してみてください。

⏱️ レート制限

• ZoomEye API はアカウントタイプに応じて異なるレート制限があります。
• リクエスト頻度を調整するか、アカウントをアップグレードして制限を引き上げてください。

✨ 主な機能

🗃️ キャッシュ機能

ZoomEye MCP サーバーは以下のキャッシュ機能を提供します。

• クエリパラメータに基づくレスポンスキャッシュ
• キャッシュ期間を設定可能（デフォルトは 1 時間）
• ignore_cache を true に設定するとキャッシュを無視できます。

📋 カスタムフィールド

fields パラメータで返すフィールドを指定できます。

{
  "name": "zoomeye_search",
  "arguments": {
    "qbase64": "app=\"Apache\"",
    "fields": "ip,port,domain,service,os,country,city"
  }
}

📄 ページング機能

大量の結果がある場合、ページングを使用できます。

{
  "name": "zoomeye_search",
  "arguments": {
    "qbase64": "app=\"Apache\"",
    "page": 2,
    "pagesize": 50
  }
}

🤝 貢献とライセンス

📤 コードの提出

GitHub を通じて PR を提出してコードに貢献してください。

git clone git@github.com:yourusername/mcp-server-zoomeye.git
cd mcp-server-zoomeye
npm install

📄 ライセンス

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

📞 連絡先

質問や提案がある場合は、以下の方法で連絡してください。

• メール: support@zoomeye.com
• 微信: zoomeye_support