Hunter MCP Server

基本能力

产品定位

Hunter MCP Server 是一个提供 Hunter API 访问能力的 MCP 服务，主要用于查询和分析互联网连接的设备和服务信息。

核心功能

• 搜索功能：支持通过 IP、域名、头部信息、Web 信息、ICP 备案信息等多种条件查询 Hunter 数据库。
• 结果采样：可以限制返回的数据量，减少令牌使用，适用于处理大数据集。
• 资源管理：提供对搜索结果的资源访问，支持 URI 标识。
• CSV 导出：支持将搜索结果导出为 CSV 文件，便于进一步分析。

适用场景

• 网络安全分析
• 设备信息查询
• 服务监控

工具列表

1. search_hunter
2. 描述：搜索 Hunter 数据库中的设备和服务信息。

3. 参数：

   • query（必填）：Hunter 搜索查询（例如 'ip="1.1.1.1"'）。
   • page（可选）：结果分页的页码（默认：1）。
   • size（可选）：每页结果数量（默认：10）。
   • fields（可选）：结果中包含的字段列表（例如 ['ip', 'port', 'title']）。

4. export_to_csv

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

常见问题解答

• 如何获取 Hunter API Key？ 可以从 Hunter 平台 获取有效的 API Key。
• Node.js 版本要求？ 需要 Node.js 14.17 或更高版本。

使用教程

使用依赖

1. 确保已安装 Node.js（版本 14.17 或更高）。 bash node -v
2. 获取 Hunter API Key。

安装教程

1. 克隆仓库： bash git clone https://github.com/help116114/hunter-mcp-server.git cd hunter-mcp-server
2. 安装依赖： bash npm install
3. 构建服务器： bash npm run build
4. 设置 Hunter API Key： bash export Hunter_API_KEY="your-api-key-here"
5. 启动服务器： bash npm start

调试方式

1. 检查服务器是否正常运行： bash curl http://localhost:3000
2. 使用 search_hunter 工具测试搜索功能： bash node /path/to/hunter-mcp-server/build/index.js search_hunter --query 'ip="1.1.1.1"'
3. 使用 export_to_csv 工具测试导出功能： bash node /path/to/hunter-mcp-server/build/index.js export_to_csv --query 'ip="1.1.1.1"' --outputPath ./output.csv

许可证

该项目遵循 None 开源许可条款。