Hunter MCP Server

🚀 猎人 MCP 服务器

猎人 MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，它提供了对 Hunter (奇信) API 功能的访问。借助该服务器，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 服务器。

✨ 主要特性

• 搜索功能：可以使用各种搜索标准查询 Hunter 的数据库，例如 IP、域名、标头、网页信息、ICP 备案信息、协议/端口、应用程序组件、证书、漏洞和 TLS - jarm。
• 结果采样：能够限制响应数据，从而减少令牌使用量，在处理大数据集时非常实用。
• 资源管理：提供对搜索结果的访问，并带有适当的 URI。
• CSV 导出：支持将搜索结果导出为 CSV 文件，方便进行进一步分析。

📦 工具介绍

search_hunter

• 描述：搜索 Hunter 数据库中的设备和服务。
• 参数：
  • query (必需)：Hunter 搜索查询（例如 'ip="1.1.1.1"'）。
  • page (可选)：结果的页码（默认: 1）。
  • size (可选)：每页的结果数（默认: 10）。
  • fields (可选)：包含在结果中的字段列表（例如 ['ip', 'port', 'title']）。

export_to_csv

• 描述：将 Hunter 搜索结果导出为 CSV 文件。
• 参数：
  • query (必需)：Hunter 搜索查询（例如 'ip="1.1.1.1"'）。
  • outputPath (必需)：输出 CSV 文件的路径。
  • page (可选)：结果的页码（默认: 1）。
  • size (可选)：每页的结果数（默认: 10）。
  • fields (可选)：包含在结果中的字段列表（例如 ['ip', 'port', 'title']）。

🔧 技术需求

• Node.js：该服务器使用 Node.js 构建。请确保您安装了 Node.js（版本 14.17 或更高）。您可以从 Node.js 官方网站 下载并安装。
• Hunter API 密钥：您需要有效的 Hunter API 密钥才能访问 Hunter API。您可以从 Hunter 平台 获取 API 密钥。