ZoomEye MCP Server logo

ZoomEye MCP Server

by zoomeye-ai

The ZoomEye MCP Server is a Model Context Protocol server that allows Large Language Models (LLMs) to query ZoomEye for network asset information using dorks. It integrates with AI assistants and development environments to enable natural language interactions for searching and analyzing internet-connected devices, services, and vulnerabilities.

View on GitHub

Last updated: N/A

What is ZoomEye MCP Server?

The ZoomEye MCP Server is a server that provides network asset information based on query conditions. It allows Large Language Models (LLMs) to obtain network asset information by querying ZoomEye using dorks and other search parameters.

How to use ZoomEye MCP Server?

To use the server, you need to install it using PIP, Docker, or uv. Then, configure your AI assistant (e.g., Claude Desktop, Zed) to use the server by providing the appropriate command and arguments, including your ZoomEye API key. You can then query network information using natural language through your AI assistant.

Key features of ZoomEye MCP Server

  • Query ZoomEye for network asset information using dorks

  • Caching mechanism to improve performance and reduce API calls

  • Automatic retry mechanism for failed API requests

  • Comprehensive error handling and logging

Use cases of ZoomEye MCP Server

  • Identifying vulnerable devices on a network

  • Analyzing the security posture of a specific organization

  • Discovering internet-connected devices with specific services

  • Automating network asset discovery and analysis

FAQ from ZoomEye MCP Server

How do I get a ZoomEye API key?

Register for an account at ZoomEye and obtain your API key from your account settings.

What are the prerequisites for running the server?

You need a ZoomEye API key and a Python 3.10+ environment, or you can use Docker.

How do I configure my AI assistant to use the server?

Add the server configuration to your AI assistant's settings, including the command, arguments, and environment variables (ZOOMEYE_API_KEY).

How can I debug issues with the server?

Use the MCP Inspector to simulate client interactions and test the server. Check for authentication errors, connection issues, query syntax errors, and rate limiting.

How does caching work?

Responses are cached based on query parameters with a configurable duration. You can bypass the cache by setting ignore_cache to true in your query.