hunter-mcp-server

hunter-mcp-server

3.2

If you are the rightful owner of hunter-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Model Context Protocol (MCP) server that provides access to Hunter (Qianxin) API functionality, allowing AI assistants to query information about internet-connected devices and services.

Hunter MCP Server

A Model Context Protocol (MCP) server that provides access to Hunter (Qianxin) API functionality, allowing AI assistants to query information about internet-connected devices and services.

Installation

  1. Clone the repository:
    git clone https://github.com/help116114/hunter-mcp-server.git
    cd hunter-mcp-server
    
  2. Install dependencies:
    npm install
    
  3. Build the server:
    npm run build
    
  4. Set up your Hunter API key and email:
    export Hunter_API_KEY="your-api-key-here"
    
  5. Start the server:
    npm start
    

Setup

To integrate this server with Claude or other MCP-compatible AI assistants, follow these steps:

  1. Add the server to your MCP settings:
{
  "mcpServers": {
    "hunter": {
      "command": "node",
      "args": ["/path/to/hunter-mcp-server/build/index.js"],
      "env": {
        "HUNTER_API_KEY": "your-api-key-here"
      }
    }
  }
}
  1. Restart Claude to load the new MCP server.

Features

  • Search Functionality: Query Hunter's database using various search criteria such as IP, domain, header, web info, ICP 备案信息,protocol/port, app components, cert, vul, AS, and tls - jarm.
  • Result Sampling: Limit the response data to reduce token usage, which is useful when dealing with large datasets. Resource Management**: Provide access to search results as resources with proper URIs.
  • CSV Export: Export search results to a CSV file for further analysis.

Tools

search_hunter

  • Description: Search Hunter's database for devices and services.
  • Parameters:
    • query (required): Hunter search query (e.g., 'ip="1.1.1.1"').
    • page (optional): Page number for results pagination (default: 1).
    • size (optional): Number of results per page (default: 10).
    • fields (optional): List of fields to include in the results (e.g., ['ip', 'port', 'title']).

export_to_csv

  • Description: Export Hunter search results to a CSV file.
  • Parameters:
    • query (required): Hunter search query (e.g., 'ip="1.1.1.1"').
    • outputPath (required): Path to the output CSV file.
    • page (optional): Page number for results pagination (default: 1).
    • size (optional): Number of results per page (default: 10).
    • fields (optional): List of fields to include in the results (e.g., ['ip', 'port', 'title']).

Requirements

  • Node.js: The server is built using Node.js. Make sure - you have Node.js (version 14.17 or higher) installed on your system.
  • Hunter API Key: You need a valid Hunter API key to access the Hunter API. You can obtain the API key from the Hunter platform.