猎人 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 服务器。

功能

• 搜索功能: 使用各种搜索标准查询 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 密钥。

以上是完整的中文翻译，保持了原文的结构和内容完整性，并确保技术术语和命令行语句的准确性。