Hunter MCP Server

🚀 ハンター MCP サーバー

このサーバーは、Hunter (奇信) API の機能にアクセスできる Model Context Protocol (MCP) サーバーです。AI アシスタントがインターネット接続機器やサービスに関する情報を照会できるようにします。

🚀 クイックスタート

このサーバーを使用するには、以下の手順に従ってください。

📦 インストール

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

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

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

   npm install
   

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

   npm run build
   

4. Hunter API キーとメールアドレスを設定します。

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

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

   npm start
   

📚 ドキュメント

設定

このサーバーをClaudeや他の MCP 互換の AI アシスタントと統合するには、以下の手順に従ってください。

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

{
  "mcpServers": {
    "hunter": {
      "command": "node",
      "args": ["/path/to/hunter-mcp-server/build/index.js"],
      "env": {
        "HUNTER_API_KEY": "your-api-key-here"
      }
    }
  }
}

2. Claude を再起動して、新しい MCP サーバーを読み込みます。

✨ 主な機能

• 検索機能: IP、ドメイン名、ヘッダー、ウェブページ情報、ICP 備案情報、プロトコル/ポート、アプリケーションコンポーネント、証明書、脆弱性、TLS - jarm など、様々な検索基準を使用して、Hunter のデータベースを照会できます。
• 結果サンプリング: レスポンスデータを制限してトークン使用量を削減し、大規模なデータセットを処理する際に役立ちます。
• リソース管理: 適切な URI を使用して、検索結果にアクセスできます。
• CSV エクスポート: 検索結果を CSV ファイルにエクスポートして、さらなる分析を行うことができます。

💻 使用例

ツール

search_hunter

• 説明: Hunter データベース内のデバイスとサービスを検索します。
• パラメータ:
  • query (必須): Hunter 検索クエリ（例: 'ip="1.1.1.1"'）。
  • page (オプション): 結果のページ番号（デフォルト: 1）。
  • size (オプション): 1 ページあたりの結果数（デフォルト: 10）。
  • fields (オプション): 結果に含めるフィールドのリスト（例: ['ip', 'port', 'title']）。

export_to_csv

• 説明: Hunter 検索結果を CSV ファイルにエクスポートします。
• パラメータ:
  • query (必須): Hunter 検索クエリ（例: 'ip="1.1.1.1"'）。
  • outputPath (必須): 出力 CSV ファイルのパス。
  • page (オプション): 結果のページ番号（デフォルト: 1）。
  • size (オプション): 1 ページあたりの結果数（デフォルト: 10）。
  • fields (オプション): 結果に含めるフィールドのリスト（例: ['ip', 'port', 'title']）。

必要条件

• Node.js: このサーバーは Node.js で構築されています。Node.js（バージョン 14.17 以上）をインストールしていることを確認してください。Node.js 公式サイト からダウンロードしてインストールできます。
• Hunter API キー: Hunter API にアクセスするには、有効な Hunter API キーが必要です。Hunter プラットフォーム から API キーを取得できます。