Zoomeye MCP Server

Name: Zoomeye MCP Server
Author: help116114

@help116114

Repository

About Zoomeye MCP Server

ZoomEye MCP Server - 网络资产搜索与用户信息查询

#red-team #security-tools #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "zoomeye": {
      "command": "node",
      "args": [
        "./build/index.js"
      ],
      "env": {
        "ZOOMEYE_API_KEY": ""
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Zoomeye MCP Server?

Zoomeye MCP Server is an MCP (Model Context Protocol) server that provides access to the ZoomEye v2 API, enabling AI assistants to query internet‑wide host and web data, view account quotas, and (for paid plans) fetch IP history. It is built for developers and security researchers who want to integrate ZoomEye cyberspace search capabilities into MCP‑compatible AI tools.

How to use Zoomeye MCP Server?

Clone the repository, install dependencies with npm install, build with npm run build, export your Zoomeye API key as ZOOMEYE_API_KEY, and start the server with npm start. For integration with MCP‑compatible LLMs (e.g., Cline, Cursor, Claude), add the server configuration to your MCP settings file, specifying the build path and API key.

Key features of Zoomeye MCP Server

Host search for devices and services using ZoomEye
Web search to index web‑facing applications and components
Account info: view ZoomEye plan and remaining query quota
Result sampling to limit response sizes and select desired fields
Summarization to generate top countries, ports, and organizations
(Paid) IP history: retrieve historical scan data for a given IP

Use cases of Zoomeye MCP Server

Query internet‑wide host data (e.g., devices by IP, port, service) from an AI assistant
Index web‑facing applications and their components for security analysis
Check ZoomEye account quota and plan information programmatically
Generate quick summaries of top countries, ports, and organizations for a device type
(Paid plan) Fetch historical scan data for a specific IP address

FAQ from Zoomeye MCP Server

What are the runtime requirements?

Node.js version 16 or higher and internet access to https://api.zoomeye.org. You also need a valid ZoomEye API key, obtainable from your ZoomEye profile page.

How is authentication handled?

The server expects the ZoomEye API key to be set in the ZOOMEYE_API_KEY environment variable (or exported before starting). This key is used for all requests to the ZoomEye API.

Are there any paid‑only features?

Yes. Some Zoomeye API endpoints require a paid membership. According to the README, features such as IP history (get_history_ip), search functionality, network scanning, SSL certificate lookup, and IoT device search are only available with a paid ZoomEye API key.

What data sources does the server use?

All data comes from the ZoomEye v2 API. The server does not store any data locally; it queries ZoomEye’s cloud database on behalf of the AI assistant.

What are the limitations on result size?

Many tools accept optional max_items (default 5) and fields parameters to control the number of items and which fields are returned. The summarization tool also defaults to 5 items.