ZoomEye

v1.0.0Securitystable

A Model Context Protocol server that provides network asset information based on query conditions. This server allows LLMs to obtain network asset information and supports querying network asset information by zoomeye dork etc.

cybersecurityosintsearch-enginezoomeye
Share:
73
Stars
0
Downloads
0
Weekly
0/5

What is ZoomEye?

ZoomEye is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that provides network asset information based on query conditions. this server allows llms to obtain network asset information and supports querying network asset informa...

A Model Context Protocol server that provides network asset information based on query conditions. This server allows LLMs to obtain network asset information and supports querying network asset information by zoomeye dork etc.

This server falls under the Security category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Model Context Protocol server that provides network asset

Use Cases

Obtain network asset information using ZoomEye dork queries.
Support OSINT and cybersecurity reconnaissance workflows.
zoomeye-ai

Maintainer

LicenseMIT License
Languagepython
Versionv1.0.0
UpdatedMay 11, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx zoomeye-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use ZoomEye

The ZoomEye MCP server connects AI assistants to the ZoomEye cyberspace asset search engine, enabling real-time OSINT and network reconnaissance queries through the Model Context Protocol. Security researchers and penetration testers can use natural language to search for exposed devices, services, and web assets across the global internet using ZoomEye dork syntax, with results filtered by IP version, page size, and specific fields.

Prerequisites

  • A ZoomEye account at https://www.zoomeye.ai with an API key from your Profile page
  • Python 3.10+ installed, or Docker for a containerized setup
  • pip or uv package manager
  • An MCP-compatible client such as Claude Desktop, Cursor, or Windsurf
1

Obtain a ZoomEye API key

Register or log in at https://www.zoomeye.ai, click your avatar, go to Profile, and copy your API-KEY. Set it as an environment variable for testing.

export ZOOMEYE_API_KEY="your_api_key_here"
2

Install the mcp-server-zoomeye package

Install the ZoomEye MCP server Python package with pip.

pip install mcp-server-zoomeye
3

Test the server runs correctly

Run the server module once manually to confirm it starts without errors before adding it to your MCP client.

python -m mcp_server_zoomeye
4

Add the server to your MCP client configuration

Open your MCP client configuration (e.g. claude_desktop_config.json for Claude Desktop) and add the ZoomEye server entry with your API key as an environment variable.

{
  "mcpServers": {
    "zoomeye": {
      "command": "python",
      "args": ["-m", "mcp_server_zoomeye"],
      "env": {
        "ZOOMEYE_API_KEY": "your_api_key_here"
      }
    }
  }
}
5

Restart your MCP client and run a test query

Restart Claude Desktop or your chosen client. Ask it to search for a network asset using a ZoomEye dork to verify the connection is working.

ZoomEye Examples

Client configuration

Claude Desktop configuration for the ZoomEye MCP server. The ZOOMEYE_API_KEY must be set in the env block.

{
  "mcpServers": {
    "zoomeye": {
      "command": "python",
      "args": ["-m", "mcp_server_zoomeye"],
      "env": {
        "ZOOMEYE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Prompts to try

Example prompts to use with the ZoomEye MCP server for network asset intelligence.

- "Search ZoomEye for exposed MongoDB instances"
- "Find all devices running Apache 2.4 in Germany"
- "Search for open Elasticsearch clusters and return the first 20 results"
- "Look up network assets with ZoomEye dork 'port:22 country:US' and show me their IPs"
- "Find web servers with the title 'Cisco' using ZoomEye"

Troubleshooting ZoomEye

Authentication errors or 401 responses from the ZoomEye API

Verify your API key is correct by checking your ZoomEye Profile page. Ensure the ZOOMEYE_API_KEY environment variable is set in the env block of your MCP config, not just in your shell session.

Server starts but returns no results for queries

ZoomEye queries use base64-encoded dork strings internally. Try simpler natural language queries and let the AI encode the search string. Check your ZoomEye account quota at https://www.zoomeye.ai to ensure you have remaining API credits.

Python module not found after pip install

Ensure you are using the same Python installation that pip installed the package into. Use 'which python' and 'which pip' to confirm they point to the same environment, or use a virtual environment with 'python -m venv .venv && .venv/bin/pip install mcp-server-zoomeye'.

Frequently Asked Questions about ZoomEye

What is ZoomEye?

ZoomEye is a Model Context Protocol (MCP) server that model context protocol server that provides network asset information based on query conditions. this server allows llms to obtain network asset information and supports querying network asset information by zoomeye dork etc. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install ZoomEye?

Follow the installation instructions on the ZoomEye GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with ZoomEye?

ZoomEye works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is ZoomEye free to use?

Yes, ZoomEye is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

ZoomEye Alternatives — Similar Security Servers

Looking for alternatives to ZoomEye? Here are other popular security servers you can use with Claude, Cursor, and VS Code.

Casdoor

13.6k

An open-source Agent-first Identity and Access Management (IAM) /LLM MCP & agent gateway and auth server with web UI supporting OpenClaw, MCP, OAuth, OIDC, SAML, CAS, LDAP, SCIM, WebAuthn, TOTP, MFA, Face ID, Google Workspace, Azure AD

ghidraMCP

9.0k

An Model Context Protocol server that enables LLMs to autonomously reverse engineer applications by exposing Ghidra's decompilation and analysis tools. It allows AI agents to list code structures, rename methods, and analyze binaries directly through

HexStrike AI

8.9k

HexStrike AI MCP Agents is an advanced MCP server that lets AI agents (Claude, GPT, Copilot, etc.) autonomously run 150+ cybersecurity tools for automated pentesting, vulnerability discovery, bug bounty automation, and security research. Seamlessly b

IDA Pro MCP

8.7k

Enables AI-assisted reverse engineering in IDA Pro by providing tools to analyze binaries, decompile functions, manage comments, search patterns, and interact with the IDA database through natural language.

Anthropic Cybersecurity Skills

6.6k

754 structured cybersecurity skills for AI agents · Mapped to 5 frameworks: MITRE ATT&CK, NIST CSF 2.0, MITRE ATLAS, D3FEND & NIST AI RMF · agentskills.io standard · Works with Claude Code, GitHub Copilot, Codex CLI, Cursor, Gemini CLI & 20+ platform

Hooker

5.1k

🔥🔥 hooker is a Frida-based reverse engineering toolkit for Android. It offers a user-friendly CLI, universal scripts, auto hook generation, memory roaming to detect activities/services, one-click SOCKS5 proxy setup, Frida JustTrustMe, and BoringSSL u

Browse More Security MCP Servers

Explore all security servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "zoomeye-mcp-server": { "command": "npx", "args": ["-y", "zoomeye-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use ZoomEye?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides