Hunter MCP Server

🚀 Hunter MCP Server

A Model Context Protocol (MCP) server that provides access to the Hunter (Qixin) API functions, allowing AI assistants to query information related to Internet-connected devices and services.

🚀 Quick Start

Prerequisites

• Node.js: This server is built with Node.js. Make sure you have Node.js (version 14.17 or higher) installed. Download and install it from the official Node.js website.
• Hunter API Key: You need a valid Hunter API key to access the Hunter API. You can obtain an API key from the Hunter platform.

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 your Hunter API key and email:

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

5. Start the server:

npm start

Configuration

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"
      }
    }
  }
}

2. Restart Claude to load the new MCP server.

✨ Features

• Search Function: Query Hunter's database using various search criteria, such as IP, domain name, headers, web page information, ICP filing information, protocol/port, application components, certificates, vulnerabilities, and TLS - jarm.
• Result Sampling: Limit the response data to reduce token usage, which is very useful when dealing with large datasets.
• Resource Management: Provide access to search results with appropriate URIs.
• CSV Export: Export search results as CSV files for further analysis.

📚 Documentation

Tools

search_hunter

• Description: Search for devices and services in the Hunter database.
• Parameters:
  • query (Required): Hunter search query (e.g., 'ip="1.1.1.1"').
  • page (Optional): Page number of the results (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 as 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 of the results (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']).