[{"_1":2,"_402":-5,"_403":-5},"loaderData",{"_3":4,"_22":23,"_24":25,"_322":323},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"BOT","id",8549669,"membership","referenceId","0197a9a3-67a2-72ce-b0b5-6134e47817bd","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_68":-5,"_69":28,"_29":70,"_240":241,"_320":321},"availableLocales",[28,40,47,54,61],{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","MCP server for querying the ZoomEye API","name","ZoomEye MCP Server","readme","# ZoomEye MCP Server\n\nA Model Context Protocol (MCP) server that provides network asset information based on query conditions. This server allows Large Language Models (LLMs) to obtain network asset information by querying ZoomEye using dorks and other search parameters.\n\nThis MCP server integrates with AI assistants and development environments like Claude Desktop, Cursor, Windsurf, Cline, Continue, and Zed, enabling them to search for and analyze internet-connected devices, services, and vulnerabilities through natural language interactions.\n\n\n## Features\n\n- Query ZoomEye for network asset information using dorks\n- Caching mechanism to improve performance and reduce API calls\n- Automatic retry mechanism for failed API requests\n- Comprehensive error handling and logging\n\n## Available Tools\n\n- `zoomeye_search` - Get network asset information based on query conditions.\n - Required parameters:\n - `qbase64` (string): Base64 encoded query string for ZoomEye search\n - Optional parameters:\n - `page` (integer): View asset page number, default is 1\n - `pagesize` (integer): Number of records per page, default is 10, maximum is 1000\n - `fields` (string): The fields to return, separated by commas\n - `sub_type` (string): Data type, supports v4, v6, and web. Default is v4\n - `facets` (string): Statistical items, separated by commas if there are multiple\n - `ignore_cache` (boolean): Whether to ignore the cache\n\n## Usage Guide\n\n### Basic Usage\n\nOnce the server is running, you can interact with it through your AI assistant or development environment. Here's how to use it:\n\n1. **Start the server** using one of the installation methods above\n2. **Configure your AI assistant** (Claude Desktop, Cursor, Windsurf, Cline, Continue, Zed, etc.) to use the server\n3. **Query network information** using natural language\n\n![searchexample](example.png)\n\n### Search Syntax Guide\n\n- Search Scope covers devices (IPv4, IPv6) and websites (domains).\n- When entering a search string, the system will match keywords in \"global\" mode, including content from various\n protocols such as HTTP, SSH, FTP, etc. (e.g., HTTP/HTTPS protocol headers, body, SSL, title, and other protocol\n banners).\n- Search strings are case-insensitive and will be segmented for matching (the search results page provides a \"\n segmentation\" test feature). When using == for search, it enforces exact case-sensitive matching with strict syntax.\n- Please use quotes for search strings (e.g., \"Cisco System\" or 'Cisco System'). If the search string contains quotes,\n use the escape character, e.g.,\"a\\\"b\". If the search string contains parentheses, use the escape character, e.g.,\n portinfo\\(\\).\n\nYou can see more detailed search syntax rules in [prompts.py](./src/mcp_server_zoomeye/prompts.py).\n\nFor more information on the ZoomEye Search API, refer to the [ZoomEye API v2 documentation](https://www.zoomeye.ai/doc).\n\n## Getting Started\n\n### Prerequisites\n\n1. **ZoomEye API Key**\n - Register for an account at [ZoomEye](https://www.zoomeye.ai/)\n - Obtain your API key from your account settings\n - The API key will be used to authenticate your requests to the ZoomEye API\n\n2. **Python Environment**\n - Python 3.10 or higher is required\n - Alternatively, you can use Docker to run the server without installing Python\n\n## Installation\n\n### Using PIP\n\nAlternatively, you can install `mcp-server-zoomeye` via pip:\n\n```bash\npip install mcp-server-zoomeye\n```\n\nAfter installation, you can run it as a script using the following command:\n\n```bash\npython -m mcp_server_zoomeye\n```\n\n### Using Docker\n\nYou can also run the ZoomEye MCP server using Docker:\n\n#### Pull from Docker Hub\n\n```bash\n# Pull the latest image\ndocker pull zoomeyeteam/mcp-server-zoomeye:latest\n\n# Run the container with your API key\ndocker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:latest\n```\n\n> **Note**: We provide multi-architecture Docker images that support `linux/amd64` and `linux/arm64` platforms and can run on Intel/AMD and ARM (such as Apple Silicon) processors.\n\n#### Build from Source\n\nAlternatively, you can build the Docker image from source:\n\n```bash\n# Clone the repository\ngit clone https://github.com/zoomeye-ai/mcp_zoomeye.git\ncd mcp_zoomeye\n\n# Build the Docker image\ndocker build -t zoomeyeteam/mcp-server-zoomeye:local .\n\n# Run the container\ndocker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:local\n\n```\n\n### Using uv\n\n[`uv`](https://docs.astral.sh/uv/) is a fast Python package installer and resolver written in Rust. It's a modern alternative to pip that offers significant performance improvements.\n\n#### Installation of uv\n\n```bash\n# Install uv using curl (macOS/Linux)\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Or using PowerShell (Windows)\nirm https://astral.sh/uv/install.ps1 | iex\n\n# Or using Homebrew (macOS)\nbrew install uv\n```\n\n#### Using uvx to run mcp-server-zoomeye\n\nNo specific installation is required when using [`uvx`](https://docs.astral.sh/uv/guides/tools/), which allows you to run Python packages directly:\n\n#### Installing with uv\n\nAlternatively, you can install the package using uv:\n\n```bash\n# Install in the current environment\nuv pip install mcp-server-zoomeye\n\n# Or create and install in a new virtual environment\nuv venv\nuv pip install mcp-server-zoomeye\n```\n\n\n## Configuration\n\n### Environment Variables\n\nThe ZoomEye MCP server requires the following environment variable:\n\n- `ZOOMEYE_API_KEY`: Your ZoomEye API key for authentication\n\nYou can set this environment variable in several ways:\n\n1. **Export in your shell session**:\n ```bash\n export ZOOMEYE_API_KEY=\"your_api_key_here\"\n ```\n\n2. **Pass directly when running the container** (for Docker):\n ```bash\n docker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:latest\n ```\n\n### Configure Claude.app\n\nAdd the following in Claude settings:\n\n

Using uvx

\n\n```json\n\"mcpServers\": {\n \"zoomeye\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n}\n```\n

\n\n

Using docker

\n\n```json\n\"mcpServers\": {\n \"zoomeye\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"-i\", \"--rm\", \"-e\", \"ZOOMEYE_API_KEY=your_api_key_here\", \"zoomeyeteam/mcp-server-zoomeye:latest\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n}\n```\n

\n\n

Installed via pip

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

\n\n### Configure Zed\n\nAdd the following in Zed's settings.json:\n\n

Using uvx

\n\n```json\n\"context_servers\": [\n \"mcp-server-zoomeye\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n],\n```\n

\n\n

Installed via pip

\n\n```json\n\"context_servers\": {\n \"mcp-server-zoomeye\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"mcp_server_zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n},\n```\n

\n\n\n## Example Interactions\n\n### Example 1: Retrieve global Apache Tomcat assets\n```json\n{\n \"name\": \"zoomeye_search\",\n \"arguments\": {\n \"qbase64\": \"app=\\\"Apache Tomcat\\\"\"\n }\n}\n```\nResponse:\n```json\n{\n \"code\": 60000,\n \"message\": \"success\",\n \"total\": 163139107,\n \"query\": \"title=\\\"cisco vpn\\\"\",\n \"data\": [\n {\n \"url\": \"https://1.1.1.1:443\",\n \"ssl.jarm\": \"29d29d15d29d29d00029d29d29d29dea0f89a2e5fb09e4d8e099befed92cfa\",\n \"ssl.ja3s\": \"45094d08156d110d8ee97b204143db14\",\n \"iconhash_md5\": \"f3418a443e7d841097c714d69ec4bcb8\",\n \"robots_md5\": \"0b5ce08db7fb8fffe4e14d05588d49d9\",\n \"security_md5\": \"0b5ce08db7fb8fffe4e14d05588d49d9\",\n \"ip\": \"1.1.1.1\",\n \"domain\": \"www.google.com\",\n \"hostname\": \"SPACEX\",\n \"os\": \"windows\",\n \"port\": 443,\n \"service\": \"https\",\n \"title\": [\"GoogleGoogle appsGoogle Search\"],\n \"version\": \"1.1.0\",\n \"device\": \"webcam\",\n \"rdns\": \"c01031-001.cust.wallcloud.ch\",\n \"product\": \"OpenSSD\",\n \"header\": \"HTTP/1.1 302 Found Location: https://www.google.com/?gws_rd=ssl Cache-Control: private...\",\n \"header_hash\": \"27f9973fe57298c3b63919259877a84d\",\n \"body\": \"HTTP/1.1 302 Found Location: https://www.google.com/?gws_rd=ssl Cache-Control: private...\",\n \"body_hash\": \"84a18166fde3ee7e7c974b8d1e7e21b4\",\n \"banner\": \"SSH-2.0-OpenSSH_7.6p1 Ubuntu-4ubuntu0.3\",\n \"update_time\": \"2024-07-03T14:34:10\",\n \"header.server.name\": \"nginx\",\n \"header.server.version\": \"1.8.1\",\n \"continent.name\": \"Europe\",\n \"country.name\": \"Germany\",\n \"province.name\": \"Hesse\",\n \"city.name\": \"Frankfurt\",\n \"lon\": \"118.753262\",\n \"lat\": \"32.064838\",\n \"isp.name\": \"aviel.ru\",\n \"organization.name\": \"SERVISFIRST BANK\",\n \"zipcode\": \"210003\",\n \"idc\": 0,\n \"honeypot\": 0,\n \"asn\": 4837,\n \"protocol\": \"tcp\",\n \"ssl\": \"SSL Certificate Version: TLS 1.2 CipherSuit: TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256...\",\n \"primary_industry\": \"Finance\",\n \"sub_industry\": \"bank\",\n \"rank\": 60\n }\n ]\n}\n```\n\n## Debugging and Troubleshooting\n\n### Using MCP Inspector\n\nThe Model Context Protocol Inspector is a tool that helps debug MCP servers by simulating client interactions. You can use it to test your ZoomEye MCP server:\n\n```bash\n# For uvx installation\nnpx @modelcontextprotocol/inspector uvx mcp-server-zoomeye\n\n# If developing locally\ncd path/to/servers/src/mcp_server_zoomeye\nnpx @modelcontextprotocol/inspector uv run mcp-server-zoomeye\n```\n\n### Common Issues\n\n1. **Authentication Errors**\n - Ensure your ZoomEye API key is correct and properly set as an environment variable\n - Check that your API key has not expired or been revoked\n\n2. **Connection Issues**\n - Verify your internet connection\n - Check if the ZoomEye API is experiencing downtime\n\n3. **No Results**\n - Your query might be too specific or contain syntax errors\n - Try simplifying your query or using different search terms\n\n4. **Rate Limiting**\n - ZoomEye API has rate limits based on your account type\n - Space out your requests or upgrade your account for higher limits\n\n## Advanced Usage\n\n### Caching\n\nThe ZoomEye MCP server implements caching to improve performance and reduce API calls:\n\n- Responses are cached based on the query parameters\n- Cache duration is configurable (default: 1 hour)\n- You can bypass the cache by setting `ignore_cache` to `true` in your query\n\n### Custom Fields\n\nYou can request specific fields in your query results by using the `fields` parameter:\n\n```json\n{\n \"name\": \"zoomeye_search\",\n \"arguments\": {\n \"qbase64\": \"app=\\\"Apache\\\"\",\n \"fields\": \"ip,port,domain,service,os,country,city\"\n }\n}\n```\n\n### Pagination\n\nFor queries that return many results, you can paginate through them:\n\n```json\n{\n \"name\": \"zoomeye_search\",\n \"arguments\": {\n \"qbase64\": \"app=\\\"Apache\\\"\",\n \"page\": 2,\n \"pagesize\": 20\n }\n}\n```\n\n## Contributing\n\nWe encourage contributions to mcp-server-zoomeye to help expand and improve its functionality. Whether it's adding new related tools, enhancing existing features, or improving documentation, your input is valuable.\n\nFor examples of other MCP servers and implementation patterns, see:\nhttps://github.com/modelcontextprotocol/servers\n\nPull requests are welcome! Feel free to contribute new ideas, bug fixes, or enhancements to make mcp-server-zoomeye more robust and practical.\n\n## License\n\nmcp-server-zoomeye is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more information, see the LICENSE file in the project repository.","English","tag","en-US",{"_29":41,"_33":45,"_38":46},{"_31":42,"_33":43,"_35":44},"Servidor MCP para consultar la API de ZoomEye","Servidor MCP de ZoomEye","# Servidor MCP de ZoomEye\n\nUn servidor de Protocolo de Contexto de Modelo (MCP) que proporciona información sobre activos de red según las condiciones de consulta. Este servidor permite que los Modelos de Lenguaje Grande (LLM) obtengan información sobre activos de red consultando ZoomEye mediante dorks y otros parámetros de búsqueda.\n\nEste servidor MCP se integra con asistentes de IA y entornos de desarrollo como Claude Desktop, Cursor, Windsurf, Cline, Continue y Zed, lo que les permite buscar y analizar dispositivos, servicios y vulnerabilidades conectados a Internet a través de interacciones de lenguaje natural.\n\n## Características\n\n* Consultar ZoomEye para obtener información sobre activos de red mediante dorks\n* Mecanismo de almacenamiento en caché para mejorar el rendimiento y reducir las llamadas a la API\n* Mecanismo de reintento automático para solicitudes de API fallidas\n* Manejo y registro de errores integral\n\n## Herramientas disponibles\n\n* `zoomeye_search` : obtiene información de activos de red según las condiciones de consulta.\n * Parámetros requeridos:\n * `qbase64` (cadena): cadena de consulta codificada en Base64 para la búsqueda de ZoomEye\n * Parámetros opcionales:\n * `page` (entero): Ver número de página del activo, el valor predeterminado es 1\n * `pagesize` (entero): Número de registros por página, el valor predeterminado es 10, el máximo es 1000\n * `fields` (cadena): Los campos a devolver, separados por comas\n * `sub_type` (cadena): Tipo de dato, compatible con v4, v6 y web. El valor predeterminado es v4.\n * `facets` (cadena): elementos estadísticos, separados por comas si hay varios\n * `ignore_cache` (booleano): si se debe ignorar el caché\n\n## Guía de uso\n\n### Uso básico\n\nUna vez que el servidor esté en funcionamiento, puedes interactuar con él a través de tu asistente de IA o entorno de desarrollo. Así es como se usa:\n\n1. **Inicie el servidor** utilizando uno de los métodos de instalación anteriores\n2. **Configura tu asistente de IA** (Claude Desktop, Cursor, Windsurf, Cline, Continue, Zed, etc.) para usar el servidor\n3. **Consultar información de la red** utilizando lenguaje natural\n\n![ejemplo de búsqueda](example.png)\n\n### Guía de sintaxis de búsqueda\n\n* El alcance de búsqueda cubre dispositivos (IPv4, IPv6) y sitios web (dominios).\n* Al ingresar una cadena de búsqueda, el sistema coincidirá con palabras clave en modo \"global\", incluido el contenido de varios protocolos como HTTP, SSH, FTP, etc. (por ejemplo, encabezados de protocolo HTTP/HTTPS, cuerpo, SSL, título y otros banners de protocolo).\n* Las cadenas de búsqueda no distinguen entre mayúsculas y minúsculas y se segmentarán para su coincidencia (la página de resultados de búsqueda ofrece una función de prueba de segmentación). Al usar == para la búsqueda, se aplica una coincidencia exacta, distinguiendo entre mayúsculas y minúsculas, con una sintaxis estricta.\n* Utilice comillas para las cadenas de búsqueda (p. ej., \"Sistema Cisco\" o 'Sistema Cisco'). Si la cadena de búsqueda contiene comillas, utilice el carácter de escape, p. ej., \"a\" o \"b\". Si la cadena de búsqueda contiene paréntesis, utilice el carácter de escape, p. ej., portinfo().\n\nPuede ver reglas de sintaxis de búsqueda más detalladas en [prompts.py](./src/mcp_server_zoomeye/prompts.py) .\n\nPara obtener más información sobre la API de búsqueda de ZoomEye, consulte la [documentación de la API de ZoomEye v2](https://www.zoomeye.ai/doc) .\n\n## Empezando\n\n### Prerrequisitos\n\n1. **Clave API de ZoomEye**\n\n * Regístrese para obtener una cuenta en [ZoomEye](https://www.zoomeye.ai/)\n * Obtén tu clave API desde la configuración de tu cuenta\n * La clave API se utilizará para autenticar sus solicitudes a la API de ZoomEye\n\n2. **Entorno de Python**\n\n * Se requiere Python 3.10 o superior\n * Alternativamente, puede usar Docker para ejecutar el servidor sin instalar Python\n\n## Instalación\n\n### Uso de PIP\n\nAlternativamente, puede instalar `mcp-server-zoomeye` a través de pip:\n\n```bash\npip install mcp-server-zoomeye\n```\n\nDespués de la instalación, puedes ejecutarlo como un script usando el siguiente comando:\n\n```bash\npython -m mcp_server_zoomeye\n```\n\n### Usando Docker\n\nTambién puede ejecutar el servidor ZoomEye MCP usando Docker:\n\n#### Extraer desde Docker Hub\n\n```bash\n# Pull the latest image\ndocker pull zoomeyeteam/mcp-server-zoomeye:latest\n\n# Run the container with your API key\ndocker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:latest\n```\n\n> **Nota** : Proporcionamos imágenes Docker de múltiples arquitecturas que admiten plataformas `linux/amd64` y `linux/arm64` y pueden ejecutarse en procesadores Intel/AMD y ARM (como Apple Silicon).\n\n#### Construir desde la fuente\n\nAlternativamente, puedes crear la imagen de Docker desde la fuente:\n\n```bash\n# Clone the repository\ngit clone https://github.com/zoomeye-ai/mcp_zoomeye.git\ncd mcp_zoomeye\n\n# Build the Docker image\ndocker build -t zoomeyeteam/mcp-server-zoomeye:local .\n\n# Run the container\ndocker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:local\n\n```\n\n### Usando uv\n\n[`uv`](https://docs.astral.sh/uv/) es un instalador y solucionador rápido de paquetes de Python escrito en Rust. Es una alternativa moderna a pip que ofrece mejoras significativas de rendimiento.\n\n#### Instalación de uv\n\n```bash\n# Install uv using curl (macOS/Linux)\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Or using PowerShell (Windows)\nirm https://astral.sh/uv/install.ps1 | iex\n\n# Or using Homebrew (macOS)\nbrew install uv\n```\n\n#### Usando uvx para ejecutar mcp-server-zoomeye\n\nNo se requiere ninguna instalación específica al utilizar [`uvx`](https://docs.astral.sh/uv/guides/tools/) , lo que le permite ejecutar paquetes de Python directamente:\n\n#### Instalación con uv\n\nAlternativamente, puede instalar el paquete usando uv:\n\n```bash\n# Install in the current environment\nuv pip install mcp-server-zoomeye\n\n# Or create and install in a new virtual environment\nuv venv\nuv pip install mcp-server-zoomeye\n```\n\n## Configuración\n\n### Variables de entorno\n\nEl servidor ZoomEye MCP requiere la siguiente variable de entorno:\n\n* `ZOOMEYE_API_KEY` : Su clave API de ZoomEye para autenticación\n\nPuede configurar esta variable de entorno de varias maneras:\n\n1. **Exportar en su sesión de shell** :\n\n ```bash\n export ZOOMEYE_API_KEY=\"your_api_key_here\"\n ```\n\n2. **Pasar directamente al ejecutar el contenedor** (para Docker):\n\n ```bash\n docker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:latest\n ```\n\n### Configurar Claude.app\n\nAgregue lo siguiente en la configuración de Claude:\n\n```json\n\"mcpServers\": {\n \"zoomeye\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n}\n```\n\n```json\n\"mcpServers\": {\n \"zoomeye\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"-i\", \"--rm\", \"-e\", \"ZOOMEYE_API_KEY=your_api_key_here\", \"zoomeyeteam/mcp-server-zoomeye:latest\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n}\n```\n\n```json\n\"mcpServers\": {\n \"zoomeye\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"mcp_server_zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n}\n```\n\n### Configurar Zed\n\nAgregue lo siguiente en settings.json de Zed:\n\n```json\n\"context_servers\": [\n \"mcp-server-zoomeye\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n],\n```\n\n```json\n\"context_servers\": {\n \"mcp-server-zoomeye\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"mcp_server_zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n},\n```\n\n## Ejemplos de interacciones\n\n### Ejemplo 1: Recuperar activos globales de Apache Tomcat\n\n```json\n{\n \"name\": \"zoomeye_search\",\n \"arguments\": {\n \"qbase64\": \"app=\\\"Apache Tomcat\\\"\"\n }\n}\n```\n\nRespuesta:\n\n```json\n{\n \"code\": 60000,\n \"message\": \"success\",\n \"total\": 163139107,\n \"query\": \"title=\\\"cisco vpn\\\"\",\n \"data\": [\n {\n \"url\": \"https://1.1.1.1:443\",\n \"ssl.jarm\": \"29d29d15d29d29d00029d29d29d29dea0f89a2e5fb09e4d8e099befed92cfa\",\n \"ssl.ja3s\": \"45094d08156d110d8ee97b204143db14\",\n \"iconhash_md5\": \"f3418a443e7d841097c714d69ec4bcb8\",\n \"robots_md5\": \"0b5ce08db7fb8fffe4e14d05588d49d9\",\n \"security_md5\": \"0b5ce08db7fb8fffe4e14d05588d49d9\",\n \"ip\": \"1.1.1.1\",\n \"domain\": \"www.google.com\",\n \"hostname\": \"SPACEX\",\n \"os\": \"windows\",\n \"port\": 443,\n \"service\": \"https\",\n \"title\": [\"GoogleGoogle appsGoogle Search\"],\n \"version\": \"1.1.0\",\n \"device\": \"webcam\",\n \"rdns\": \"c01031-001.cust.wallcloud.ch\",\n \"product\": \"OpenSSD\",\n \"header\": \"HTTP/1.1 302 Found Location: https://www.google.com/?gws_rd=ssl Cache-Control: private...\",\n \"header_hash\": \"27f9973fe57298c3b63919259877a84d\",\n \"body\": \"HTTP/1.1 302 Found Location: https://www.google.com/?gws_rd=ssl Cache-Control: private...\",\n \"body_hash\": \"84a18166fde3ee7e7c974b8d1e7e21b4\",\n \"banner\": \"SSH-2.0-OpenSSH_7.6p1 Ubuntu-4ubuntu0.3\",\n \"update_time\": \"2024-07-03T14:34:10\",\n \"header.server.name\": \"nginx\",\n \"header.server.version\": \"1.8.1\",\n \"continent.name\": \"Europe\",\n \"country.name\": \"Germany\",\n \"province.name\": \"Hesse\",\n \"city.name\": \"Frankfurt\",\n \"lon\": \"118.753262\",\n \"lat\": \"32.064838\",\n \"isp.name\": \"aviel.ru\",\n \"organization.name\": \"SERVISFIRST BANK\",\n \"zipcode\": \"210003\",\n \"idc\": 0,\n \"honeypot\": 0,\n \"asn\": 4837,\n \"protocol\": \"tcp\",\n \"ssl\": \"SSL Certificate Version: TLS 1.2 CipherSuit: TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256...\",\n \"primary_industry\": \"Finance\",\n \"sub_industry\": \"bank\",\n \"rank\": 60\n }\n ]\n}\n```\n\n## Depuración y solución de problemas\n\n### Uso del inspector MCP\n\nEl Inspector de Protocolo de Contexto de Modelo es una herramienta que ayuda a depurar servidores MCP mediante la simulación de interacciones con el cliente. Puede usarlo para probar su servidor MCP de ZoomEye:\n\n```bash\n# For uvx installation\nnpx @modelcontextprotocol/inspector uvx mcp-server-zoomeye\n\n# If developing locally\ncd path/to/servers/src/mcp_server_zoomeye\nnpx @modelcontextprotocol/inspector uv run mcp-server-zoomeye\n```\n\n### Problemas comunes\n\n1. **Errores de autenticación**\n\n * Asegúrese de que su clave API de ZoomEye sea correcta y esté configurada correctamente como variable de entorno\n * Comprueba que tu clave API no haya caducado ni haya sido revocada\n\n2. **Problemas de conexión**\n\n * Verificar su conexión a Internet\n * Compruebe si la API de ZoomEye está experimentando un tiempo de inactividad\n\n3. **No hay resultados**\n\n * Su consulta podría ser demasiado específica o contener errores de sintaxis.\n * Intente simplificar su consulta o utilizar términos de búsqueda diferentes.\n\n4. **Limitación de velocidad**\n\n * La API de ZoomEye tiene límites de velocidad según el tipo de cuenta\n * Distribuya sus solicitudes o actualice su cuenta para obtener límites más altos\n\n## Uso avanzado\n\n### Almacenamiento en caché\n\nEl servidor MCP de ZoomEye implementa el almacenamiento en caché para mejorar el rendimiento y reducir las llamadas API:\n\n* Las respuestas se almacenan en caché en función de los parámetros de consulta.\n* La duración del caché es configurable (predeterminado: 1 hora)\n* Puede omitir el caché configurando `ignore_cache` como `true` en su consulta\n\n### Campos personalizados\n\nPuede solicitar campos específicos en los resultados de su consulta utilizando el parámetro `fields` :\n\n```json\n{\n \"name\": \"zoomeye_search\",\n \"arguments\": {\n \"qbase64\": \"app=\\\"Apache\\\"\",\n \"fields\": \"ip,port,domain,service,os,country,city\"\n }\n}\n```\n\n### Paginación\n\nPara las consultas que devuelven muchos resultados, puede paginarlos:\n\n```json\n{\n \"name\": \"zoomeye_search\",\n \"arguments\": {\n \"qbase64\": \"app=\\\"Apache\\\"\",\n \"page\": 2,\n \"pagesize\": 20\n }\n}\n```\n\n## Contribuyendo\n\nInvitamos a contribuir a mcp-server-zoomeye para ampliar y mejorar su funcionalidad. Ya sea añadiendo nuevas herramientas relacionadas, mejorando funciones existentes o mejorando la documentación, su aportación es valiosa.\n\nPara ver ejemplos de otros servidores MCP y patrones de implementación, consulte: \n\n¡Aceptamos solicitudes de incorporación de cambios! Siéntete libre de contribuir con nuevas ideas, correcciones de errores o mejoras para que mcp-server-zoomeye sea más robusto y práctico.\n\n## Licencia\n\nmcp-server-zoomeye está licenciado bajo la Licencia MIT. Esto significa que usted tiene libertad de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más información, consulte el archivo de LICENCIA en el repositorio del proyecto.","Spanish","es-ES",{"_29":48,"_33":52,"_38":53},{"_31":49,"_33":50,"_35":51},"ZoomEye API をクエリするための MCP サーバー","ZoomEye MCP サーバー","# ZoomEye MCP サーバー\n\nクエリ条件に基づいてネットワーク資産情報を提供するモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、大規模言語モデル（LLM）は、dorksやその他の検索パラメータを使用してZoomEyeにクエリを実行し、ネットワーク資産情報を取得できます。\n\nこの MCP サーバーは、Claude Desktop、Cursor、Windsurf、Cline、Continue、Zed などの AI アシスタントや開発環境と統合され、自然言語による対話を通じてインターネットに接続されたデバイス、サービス、脆弱性を検索および分析できるようになります。\n\n## 特徴\n\n* dorksを使用してZoomEyeにネットワーク資産情報を照会する\n* パフォーマンスを向上させ、API呼び出しを削減するキャッシュメカニズム\n* 失敗したAPIリクエストの自動再試行メカニズム\n* 包括的なエラー処理とログ記録\n\n## 利用可能なツール\n\n* `zoomeye_search` - クエリ条件に基づいてネットワーク資産情報を取得します。\n * 必須パラメータ:\n * `qbase64` (文字列): ZoomEye検索用のBase64エンコードされたクエリ文字列\n * オプションパラメータ:\n * `page` (整数): ビューアセットのページ番号。デフォルトは 1\n * `pagesize` (整数): ページあたりのレコード数。デフォルトは 10、最大値は 1000\n * `fields` (文字列): 返されるフィールド（カンマ区切り）\n * `sub_type` (文字列): データ型。v4、v6、web をサポートします。デフォルトは v4 です。\n * `facets` （文字列）：統計項目。複数ある場合はカンマで区切る。\n * `ignore_cache` (boolean): キャッシュを無視するかどうか\n\n## 使用ガイド\n\n### 基本的な使い方\n\nサーバーが起動したら、AIアシスタントや開発環境からサーバーとやり取りできるようになります。使い方は以下のとおりです。\n\n1. 上記のインストール方法のいずれかを使用して**サーバーを起動します**\n2. **AIアシスタント（Claude Desktop、Cursor、Windsurf、Cline、Continue、Zedなど）をサーバーを使用するように設定します**\n3. 自然言語を使用して**ネットワーク情報を照会する**\n\n![検索例](example.png)\n\n### 検索構文ガイド\n\n* 検索範囲はデバイス (IPv4、IPv6) と Web サイト (ドメイン) をカバーします。\n* 検索文字列を入力すると、システムは、HTTP、SSH、FTP などのさまざまなプロトコルのコンテンツ (HTTP/HTTPS プロトコルヘッダー、本文、SSL、タイトル、その他のプロトコルバナーなど) を含むキーワードを「グローバル」モードで照合します。\n* 検索文字列は大文字と小文字を区別せず、一致のために分割されます（検索結果ページには「分割」テスト機能があります）。== を使用した検索では、大文字と小文字を区別した厳密な構文による一致が強制されます。\n* 検索文字列には引用符を使用してください（例：\"Cisco System\" または 'Cisco System'）。検索文字列に引用符が含まれている場合は、エスケープ文字を使用してください（例：,\"a\"b）。検索文字列に括弧が含まれている場合は、エスケープ文字を使用してください（例：portinfo()）。\n\nより詳細な検索構文ルールについては[prompts.py](./src/mcp_server_zoomeye/prompts.py)で確認できます。\n\nZoomEye 検索 API の詳細については、 [ZoomEye API v2 ドキュメント](https://www.zoomeye.ai/doc)を参照してください。\n\n## はじめる\n\n### 前提条件\n\n1. **ZoomEye APIキー**\n\n * [ZoomEye](https://www.zoomeye.ai/)でアカウントを登録する\n * アカウント設定からAPIキーを取得します\n * APIキーはZoomEye APIへのリクエストを認証するために使用されます\n\n2. **Python環境**\n\n * Python 3.10以上が必要です\n * あるいは、PythonをインストールせずにDockerを使用してサーバーを実行することもできます。\n\n## インストール\n\n### PIPの使用\n\nあるいは、pip 経由で`mcp-server-zoomeye`をインストールすることもできます。\n\n```bash\npip install mcp-server-zoomeye\n```\n\nインストール後、次のコマンドを使用してスクリプトとして実行できます。\n\n```bash\npython -m mcp_server_zoomeye\n```\n\n### Dockerの使用\n\nDocker を使用して ZoomEye MCP サーバーを実行することもできます。\n\n#### Docker Hubからプル\n\n```bash\n# Pull the latest image\ndocker pull zoomeyeteam/mcp-server-zoomeye:latest\n\n# Run the container with your API key\ndocker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:latest\n```\n\n> **注**: `linux/amd64`および`linux/arm64`プラットフォームをサポートし、Intel/AMD および ARM (Apple Silicon など) プロセッサで実行できるマルチアーキテクチャ Docker イメージを提供します。\n\n#### ソースからビルド\n\nあるいは、ソースから Docker イメージをビルドすることもできます。\n\n```bash\n# Clone the repository\ngit clone https://github.com/zoomeye-ai/mcp_zoomeye.git\ncd mcp_zoomeye\n\n# Build the Docker image\ndocker build -t zoomeyeteam/mcp-server-zoomeye:local .\n\n# Run the container\ndocker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:local\n\n```\n\n### UVの使用\n\n[`uv`](https://docs.astral.sh/uv/)はRustで書かれた高速なPythonパッケージインストーラー兼リゾルバーです。pipの現代的な代替手段であり、大幅なパフォーマンス向上を実現します。\n\n#### UVの設置\n\n```bash\n# Install uv using curl (macOS/Linux)\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Or using PowerShell (Windows)\nirm https://astral.sh/uv/install.ps1 | iex\n\n# Or using Homebrew (macOS)\nbrew install uv\n```\n\n#### uvx を使用して mcp-server-zoomeye を実行する\n\n[`uvx`](https://docs.astral.sh/uv/guides/tools/)を使用する場合、特別なインストールは必要ありません。これにより、Python パッケージを直接実行できます。\n\n#### uvでインストール\n\nあるいは、uv を使用してパッケージをインストールすることもできます。\n\n```bash\n# Install in the current environment\nuv pip install mcp-server-zoomeye\n\n# Or create and install in a new virtual environment\nuv venv\nuv pip install mcp-server-zoomeye\n```\n\n## 構成\n\n### 環境変数\n\nZoomEye MCP サーバーには次の環境変数が必要です。\n\n* `ZOOMEYE_API_KEY` : 認証用のZoomEye APIキー\n\nこの環境変数はいくつかの方法で設定できます。\n\n1. **シェルセッションでエクスポートします**:\n\n ```bash\n export ZOOMEYE_API_KEY=\"your_api_key_here\"\n ```\n\n2. **コンテナを実行するときに直接渡します**(Docker の場合):\n\n ```bash\n docker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:latest\n ```\n\n### Claude.app を設定する\n\nClaude 設定に以下を追加します。\n\n```json\n\"mcpServers\": {\n \"zoomeye\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n}\n```\n\n```json\n\"mcpServers\": {\n \"zoomeye\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"-i\", \"--rm\", \"-e\", \"ZOOMEYE_API_KEY=your_api_key_here\", \"zoomeyeteam/mcp-server-zoomeye:latest\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n}\n```\n\n```json\n\"mcpServers\": {\n \"zoomeye\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"mcp_server_zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n}\n```\n\n### Zed を設定する\n\nZed のsettings.jsonに以下を追加します。\n\n```json\n\"context_servers\": [\n \"mcp-server-zoomeye\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n],\n```\n\n```json\n\"context_servers\": {\n \"mcp-server-zoomeye\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"mcp_server_zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n},\n```\n\n## やり取りの例\n\n### 例1: グローバルApache Tomcatアセットを取得する\n\n```json\n{\n \"name\": \"zoomeye_search\",\n \"arguments\": {\n \"qbase64\": \"app=\\\"Apache Tomcat\\\"\"\n }\n}\n```\n\n応答：\n\n```json\n{\n \"code\": 60000,\n \"message\": \"success\",\n \"total\": 163139107,\n \"query\": \"title=\\\"cisco vpn\\\"\",\n \"data\": [\n {\n \"url\": \"https://1.1.1.1:443\",\n \"ssl.jarm\": \"29d29d15d29d29d00029d29d29d29dea0f89a2e5fb09e4d8e099befed92cfa\",\n \"ssl.ja3s\": \"45094d08156d110d8ee97b204143db14\",\n \"iconhash_md5\": \"f3418a443e7d841097c714d69ec4bcb8\",\n \"robots_md5\": \"0b5ce08db7fb8fffe4e14d05588d49d9\",\n \"security_md5\": \"0b5ce08db7fb8fffe4e14d05588d49d9\",\n \"ip\": \"1.1.1.1\",\n \"domain\": \"www.google.com\",\n \"hostname\": \"SPACEX\",\n \"os\": \"windows\",\n \"port\": 443,\n \"service\": \"https\",\n \"title\": [\"GoogleGoogle appsGoogle Search\"],\n \"version\": \"1.1.0\",\n \"device\": \"webcam\",\n \"rdns\": \"c01031-001.cust.wallcloud.ch\",\n \"product\": \"OpenSSD\",\n \"header\": \"HTTP/1.1 302 Found Location: https://www.google.com/?gws_rd=ssl Cache-Control: private...\",\n \"header_hash\": \"27f9973fe57298c3b63919259877a84d\",\n \"body\": \"HTTP/1.1 302 Found Location: https://www.google.com/?gws_rd=ssl Cache-Control: private...\",\n \"body_hash\": \"84a18166fde3ee7e7c974b8d1e7e21b4\",\n \"banner\": \"SSH-2.0-OpenSSH_7.6p1 Ubuntu-4ubuntu0.3\",\n \"update_time\": \"2024-07-03T14:34:10\",\n \"header.server.name\": \"nginx\",\n \"header.server.version\": \"1.8.1\",\n \"continent.name\": \"Europe\",\n \"country.name\": \"Germany\",\n \"province.name\": \"Hesse\",\n \"city.name\": \"Frankfurt\",\n \"lon\": \"118.753262\",\n \"lat\": \"32.064838\",\n \"isp.name\": \"aviel.ru\",\n \"organization.name\": \"SERVISFIRST BANK\",\n \"zipcode\": \"210003\",\n \"idc\": 0,\n \"honeypot\": 0,\n \"asn\": 4837,\n \"protocol\": \"tcp\",\n \"ssl\": \"SSL Certificate Version: TLS 1.2 CipherSuit: TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256...\",\n \"primary_industry\": \"Finance\",\n \"sub_industry\": \"bank\",\n \"rank\": 60\n }\n ]\n}\n```\n\n## デバッグとトラブルシューティング\n\n### MCPインスペクターの使用\n\nモデルコンテキストプロトコルインスペクターは、クライアントとのやり取りをシミュレートすることでMCPサーバーのデバッグを支援するツールです。ZoomEye MCPサーバーのテストに使用できます。\n\n```bash\n# For uvx installation\nnpx @modelcontextprotocol/inspector uvx mcp-server-zoomeye\n\n# If developing locally\ncd path/to/servers/src/mcp_server_zoomeye\nnpx @modelcontextprotocol/inspector uv run mcp-server-zoomeye\n```\n\n### よくある問題\n\n1. **認証エラー**\n\n * ZoomEye APIキーが正しく、環境変数として適切に設定されていることを確認してください。\n * APIキーの有効期限が切れていないか、取り消されていないか確認してください\n\n2. **接続の問題**\n\n * インターネット接続を確認してください\n * ZoomEye API がダウンしていないか確認する\n\n3. **結果なし**\n\n * クエリが具体的すぎるか、構文エラーが含まれている可能性があります\n * クエリを簡素化するか、別の検索語句を使用してみてください\n\n4. **レート制限**\n\n * ZoomEye API にはアカウントの種類に応じたレート制限があります\n * リクエストの間隔をあけるか、アカウントをアップグレードして上限額を増やしましょう\n\n## 高度な使用法\n\n### キャッシング\n\nZoomEye MCP サーバーは、パフォーマンスを向上させ、API 呼び出しを削減するためにキャッシュを実装します。\n\n* レスポンスはクエリパラメータに基づいてキャッシュされます\n* キャッシュ期間は設定可能（デフォルト: 1 時間）\n* クエリで`ignore_cache``true`に設定することでキャッシュをバイパスできます。\n\n### カスタムフィールド\n\n`fields`パラメータを使用して、クエリ結果内の特定のフィールドをリクエストできます。\n\n```json\n{\n \"name\": \"zoomeye_search\",\n \"arguments\": {\n \"qbase64\": \"app=\\\"Apache\\\"\",\n \"fields\": \"ip,port,domain,service,os,country,city\"\n }\n}\n```\n\n### ページネーション\n\n多くの結果を返すクエリの場合は、ページ分けすることができます。\n\n```json\n{\n \"name\": \"zoomeye_search\",\n \"arguments\": {\n \"qbase64\": \"app=\\\"Apache\\\"\",\n \"page\": 2,\n \"pagesize\": 20\n }\n}\n```\n\n## 貢献\n\nmcp-server-zoomeye の機能拡張と改善のため、皆様の貢献を歓迎いたします。新しい関連ツールの追加、既存機能の強化、ドキュメントの改善など、皆様からの貴重なご意見をお待ちしております。\n\n他の MCP サーバーと実装パターンの例については、https: [//github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers)を参照してください。\n\nプルリクエストを歓迎します！mcp-server-zoomeye をより堅牢で実用的なものにするために、新しいアイデア、バグ修正、機能強化などをお気軽にご提供ください。\n\n## ライセンス\n\nmcp-server-zoomeye は MIT ライセンスに基づきライセンスされています。つまり、MIT ライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布できます。詳細については、プロジェクトリポジトリの LICENSE ファイルをご覧ください。","Japanese","ja-JP",{"_29":55,"_33":59,"_38":60},{"_31":56,"_33":57,"_35":58},"ZoomEye API를 쿼리하기 위한 MCP 서버","ZoomEye MCP 서버","# ZoomEye MCP 서버\n\n쿼리 조건에 따라 네트워크 자산 정보를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 대규모 언어 모델(LLM)은 dork 및 기타 검색 매개변수를 사용하여 ZoomEye에 쿼리를 보내 네트워크 자산 정보를 얻을 수 있습니다.\n\n이 MCP 서버는 Claude Desktop, Cursor, Windsurf, Cline, Continue, Zed와 같은 AI 어시스턴트 및 개발 환경과 통합되어 자연어 상호 작용을 통해 인터넷에 연결된 장치, 서비스 및 취약점을 검색하고 분석할 수 있습니다.\n\n## 특징\n\n* dork를 사용하여 ZoomEye에서 네트워크 자산 정보 쿼리\n* 성능 향상 및 API 호출 감소를 위한 캐싱 메커니즘\n* 실패한 API 요청에 대한 자동 재시도 메커니즘\n* 포괄적인 오류 처리 및 로깅\n\n## 사용 가능한 도구\n\n* `zoomeye_search` - 쿼리 조건에 따라 네트워크 자산 정보를 가져옵니다.\n * 필수 매개변수:\n * `qbase64` (문자열): ZoomEye 검색을 위한 Base64 인코딩된 쿼리 문자열\n * 선택 매개변수:\n * `page` (정수): 자산 페이지 번호 보기, 기본값은 1입니다.\n * `pagesize` (정수): 페이지당 레코드 수, 기본값은 10, 최대값은 1000입니다.\n * `fields` (문자열): 쉼표로 구분된 반환할 필드\n * `sub_type` (문자열): 데이터 유형이며 v4, v6 및 웹을 지원합니다. 기본값은 v4입니다.\n * `facets` (문자열): 통계 항목(여러 개가 있는 경우 쉼표로 구분)\n * `ignore_cache` (부울): 캐시를 무시할지 여부\n\n## 사용 가이드\n\n### 기본 사용법\n\n서버가 실행되면 AI 어시스턴트나 개발 환경을 통해 서버와 상호 작용할 수 있습니다. 사용 방법은 다음과 같습니다.\n\n1. 위의 설치 방법 중 하나를 사용하여 **서버를 시작하세요.**\n2. **AI 어시스턴트(Claude Desktop, Cursor, Windsurf, Cline, Continue, Zed 등)를 구성하여** 서버를 사용하세요.\n3. 자연어를 사용하여 **네트워크 정보 쿼리**\n\n![검색예시](example.png)\n\n### 검색 구문 가이드\n\n* 검색 범위에는 장치(IPv4, IPv6)와 웹사이트(도메인)가 포함됩니다.\n* 검색어를 입력하면 시스템은 HTTP, SSH, FTP 등 다양한 프로토콜의 콘텐츠(예: HTTP/HTTPS 프로토콜 헤더, 본문, SSL, 제목 및 기타 프로토콜 배너)를 포함하여 \"글로벌\" 모드로 키워드를 일치시킵니다.\n* 검색 문자열은 대소문자를 구분하지 않으며, 일치 여부를 확인하기 위해 분할됩니다(검색 결과 페이지에 \"분할\" 테스트 기능이 제공됩니다). 검색에 ==를 사용하면 엄격한 구문을 사용하여 대소문자를 정확하게 구분하여 일치시킵니다.\n* 검색 문자열에는 따옴표를 사용해 주세요(예: \"Cisco System\" 또는 'Cisco System'). 검색 문자열에 따옴표가 포함된 경우 이스케이프 문자를 사용하세요(예: \"a\"b\"). 검색 문자열에 괄호가 포함된 경우 이스케이프 문자를 사용하세요(예: portinfo()).\n\n[prompts.py](./src/mcp_server_zoomeye/prompts.py) 에서 더 자세한 검색 구문 규칙을 볼 수 있습니다.\n\nZoomEye 검색 API에 대한 자세한 내용은 [ZoomEye API v2 설명서를](https://www.zoomeye.ai/doc) 참조하세요.\n\n## 시작하기\n\n### 필수 조건\n\n1. **ZoomEye API 키**\n\n * [ZoomEye](https://www.zoomeye.ai/) 에 계정을 등록하세요\n * 계정 설정에서 API 키를 받으세요\n * API 키는 ZoomEye API에 대한 요청을 인증하는 데 사용됩니다.\n\n2. **파이썬 환경**\n\n * Python 3.10 이상이 필요합니다\n * 또는 Python을 설치하지 않고도 Docker를 사용하여 서버를 실행할 수 있습니다.\n\n## 설치\n\n### PIP 사용\n\n또는 pip를 통해 `mcp-server-zoomeye` 설치할 수 있습니다.\n\n지엑스피1\n\n설치 후 다음 명령을 사용하여 스크립트로 실행할 수 있습니다.\n\n```bash\npython -m mcp_server_zoomeye\n```\n\n### Docker 사용\n\nDocker를 사용하여 ZoomEye MCP 서버를 실행할 수도 있습니다.\n\n#### Docker Hub에서 가져오기\n\n```bash\n# Pull the latest image\ndocker pull zoomeyeteam/mcp-server-zoomeye:latest\n\n# Run the container with your API key\ndocker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:latest\n```\n\n> **참고** : `linux/amd64` 및 `linux/arm64` 플랫폼을 지원하고 Intel/AMD 및 ARM(예: Apple Silicon) 프로세서에서 실행할 수 있는 다중 아키텍처 Docker 이미지를 제공합니다.\n\n#### 소스에서 빌드\n\n또는 소스에서 Docker 이미지를 빌드할 수 있습니다.\n\n```bash\n# Clone the repository\ngit clone https://github.com/zoomeye-ai/mcp_zoomeye.git\ncd mcp_zoomeye\n\n# Build the Docker image\ndocker build -t zoomeyeteam/mcp-server-zoomeye:local .\n\n# Run the container\ndocker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:local\n\n```\n\n### uv를 사용하여\n\n[`uv`](https://docs.astral.sh/uv/) 는 Rust로 작성된 빠른 Python 패키지 설치 및 해결 프로그램입니다. pip의 현대적인 대안으로, 상당한 성능 향상을 제공합니다.\n\n#### uv 설치\n\n```bash\n# Install uv using curl (macOS/Linux)\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Or using PowerShell (Windows)\nirm https://astral.sh/uv/install.ps1 | iex\n\n# Or using Homebrew (macOS)\nbrew install uv\n```\n\n#### uvx를 사용하여 mcp-server-zoomeye 실행\n\n[`uvx`](https://docs.astral.sh/uv/guides/tools/) 사용하면 특별한 설치가 필요하지 않으므로 Python 패키지를 직접 실행할 수 있습니다.\n\n#### uv로 설치하기\n\n또는 uv를 사용하여 패키지를 설치할 수 있습니다.\n\n```bash\n# Install in the current environment\nuv pip install mcp-server-zoomeye\n\n# Or create and install in a new virtual environment\nuv venv\nuv pip install mcp-server-zoomeye\n```\n\n## 구성\n\n### 환경 변수\n\nZoomEye MCP 서버에는 다음 환경 변수가 필요합니다.\n\n* `ZOOMEYE_API_KEY` : 인증을 위한 ZoomEye API 키\n\n이 환경 변수는 여러 가지 방법으로 설정할 수 있습니다.\n\n1. **셸 세션에서 내보내기** :\n\n ```bash\n export ZOOMEYE_API_KEY=\"your_api_key_here\"\n ```\n\n2. **컨테이너를 실행할 때 직접 전달합니다** (Docker의 경우):\n\n ```bash\n docker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:latest\n ```\n\n### Claude.app 구성\n\nClaude 설정에 다음을 추가합니다.\n\n```json\n\"mcpServers\": {\n \"zoomeye\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n}\n```\n\n```json\n\"mcpServers\": {\n \"zoomeye\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"-i\", \"--rm\", \"-e\", \"ZOOMEYE_API_KEY=your_api_key_here\", \"zoomeyeteam/mcp-server-zoomeye:latest\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n}\n```\n\n```json\n\"mcpServers\": {\n \"zoomeye\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"mcp_server_zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n}\n```\n\n### Zed 구성\n\nZed의 settings.json에 다음을 추가하세요.\n\n```json\n\"context_servers\": [\n \"mcp-server-zoomeye\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n],\n```\n\n```json\n\"context_servers\": {\n \"mcp-server-zoomeye\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"mcp_server_zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n},\n```\n\n## 예시 상호작용\n\n### 예제 1: 글로벌 Apache Tomcat 자산 검색\n\n```json\n{\n \"name\": \"zoomeye_search\",\n \"arguments\": {\n \"qbase64\": \"app=\\\"Apache Tomcat\\\"\"\n }\n}\n```\n\n응답:\n\n```json\n{\n \"code\": 60000,\n \"message\": \"success\",\n \"total\": 163139107,\n \"query\": \"title=\\\"cisco vpn\\\"\",\n \"data\": [\n {\n \"url\": \"https://1.1.1.1:443\",\n \"ssl.jarm\": \"29d29d15d29d29d00029d29d29d29dea0f89a2e5fb09e4d8e099befed92cfa\",\n \"ssl.ja3s\": \"45094d08156d110d8ee97b204143db14\",\n \"iconhash_md5\": \"f3418a443e7d841097c714d69ec4bcb8\",\n \"robots_md5\": \"0b5ce08db7fb8fffe4e14d05588d49d9\",\n \"security_md5\": \"0b5ce08db7fb8fffe4e14d05588d49d9\",\n \"ip\": \"1.1.1.1\",\n \"domain\": \"www.google.com\",\n \"hostname\": \"SPACEX\",\n \"os\": \"windows\",\n \"port\": 443,\n \"service\": \"https\",\n \"title\": [\"GoogleGoogle appsGoogle Search\"],\n \"version\": \"1.1.0\",\n \"device\": \"webcam\",\n \"rdns\": \"c01031-001.cust.wallcloud.ch\",\n \"product\": \"OpenSSD\",\n \"header\": \"HTTP/1.1 302 Found Location: https://www.google.com/?gws_rd=ssl Cache-Control: private...\",\n \"header_hash\": \"27f9973fe57298c3b63919259877a84d\",\n \"body\": \"HTTP/1.1 302 Found Location: https://www.google.com/?gws_rd=ssl Cache-Control: private...\",\n \"body_hash\": \"84a18166fde3ee7e7c974b8d1e7e21b4\",\n \"banner\": \"SSH-2.0-OpenSSH_7.6p1 Ubuntu-4ubuntu0.3\",\n \"update_time\": \"2024-07-03T14:34:10\",\n \"header.server.name\": \"nginx\",\n \"header.server.version\": \"1.8.1\",\n \"continent.name\": \"Europe\",\n \"country.name\": \"Germany\",\n \"province.name\": \"Hesse\",\n \"city.name\": \"Frankfurt\",\n \"lon\": \"118.753262\",\n \"lat\": \"32.064838\",\n \"isp.name\": \"aviel.ru\",\n \"organization.name\": \"SERVISFIRST BANK\",\n \"zipcode\": \"210003\",\n \"idc\": 0,\n \"honeypot\": 0,\n \"asn\": 4837,\n \"protocol\": \"tcp\",\n \"ssl\": \"SSL Certificate Version: TLS 1.2 CipherSuit: TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256...\",\n \"primary_industry\": \"Finance\",\n \"sub_industry\": \"bank\",\n \"rank\": 60\n }\n ]\n}\n```\n\n## 디버깅 및 문제 해결\n\n### MCP Inspector 사용\n\n모델 컨텍스트 프로토콜 검사기는 클라이언트 상호작용을 시뮬레이션하여 MCP 서버 디버깅을 지원하는 도구입니다. ZoomEye MCP 서버를 테스트하는 데 사용할 수 있습니다.\n\n```bash\n# For uvx installation\nnpx @modelcontextprotocol/inspector uvx mcp-server-zoomeye\n\n# If developing locally\ncd path/to/servers/src/mcp_server_zoomeye\nnpx @modelcontextprotocol/inspector uv run mcp-server-zoomeye\n```\n\n### 일반적인 문제\n\n1. **인증 오류**\n\n * ZoomEye API 키가 올바르고 환경 변수로 올바르게 설정되었는지 확인하세요.\n * API 키가 만료되거나 취소되지 않았는지 확인하세요.\n\n2. **연결 문제**\n\n * 인터넷 연결을 확인하세요\n * ZoomEye API가 다운타임을 겪고 있는지 확인하세요\n\n3. **결과 없음**\n\n * 귀하의 쿼리가 너무 구체적이거나 구문 오류가 포함되어 있을 수 있습니다.\n * 쿼리를 단순화하거나 다른 검색어를 사용해 보세요.\n\n4. **속도 제한**\n\n * ZoomEye API에는 계정 유형에 따라 요금 제한이 있습니다.\n * 요청 범위를 넓히거나 계정을 업그레이드하여 더 높은 한도를 얻으세요.\n\n## 고급 사용법\n\n### 캐싱\n\nZoomEye MCP 서버는 성능을 개선하고 API 호출을 줄이기 위해 캐싱을 구현합니다.\n\n* 응답은 쿼리 매개변수를 기반으로 캐시됩니다.\n* 캐시 기간은 구성 가능합니다(기본값: 1시간)\n* 쿼리에서 `ignore_cache``true` 로 설정하여 캐시를 우회할 수 있습니다.\n\n### 사용자 정의 필드\n\n`fields` 매개변수를 사용하여 쿼리 결과에서 특정 필드를 요청할 수 있습니다.\n\n```json\n{\n \"name\": \"zoomeye_search\",\n \"arguments\": {\n \"qbase64\": \"app=\\\"Apache\\\"\",\n \"fields\": \"ip,port,domain,service,os,country,city\"\n }\n}\n```\n\n### 쪽수 매기기\n\n많은 결과를 반환하는 쿼리의 경우, 결과를 페이지별로 살펴볼 수 있습니다.\n\n```json\n{\n \"name\": \"zoomeye_search\",\n \"arguments\": {\n \"qbase64\": \"app=\\\"Apache\\\"\",\n \"page\": 2,\n \"pagesize\": 20\n }\n}\n```\n\n## 기여하다\n\nmcp-server-zoomeye의 기능을 확장하고 개선하는 데 도움이 되도록 기여해 주시기 바랍니다. 새로운 관련 도구를 추가하거나, 기존 기능을 강화하거나, 문서를 개선하는 등 여러분의 의견은 소중합니다.\n\n다른 MCP 서버 및 구현 패턴의 예는 [https://github.com/modelcontextprotocol/servers를](https://github.com/modelcontextprotocol/servers) 참조하세요.\n\n풀 리퀘스트를 환영합니다! mcp-server-zoomeye를 더욱 강력하고 실용적으로 만들기 위한 새로운 아이디어, 버그 수정, 개선 사항을 자유롭게 공유해 주세요.\n\n## 특허\n\nmcp-server-zoomeye는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 ��습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.","Korean","ko-KR",{"_29":62,"_33":66,"_38":67},{"_31":63,"_33":64,"_35":65},"用于查询 ZoomEye API 的 MCP 服务器","ZoomEye MCP 服务器","# ZoomEye MCP 服务器\n\n模型上下文协议 (MCP) 服务器，根据查询条件提供网络资产信息。该服务器允许大型语言模型 (LLM) 通过使用 dork 和其他搜索参数查询 ZoomEye 来获取网络资产信息。\n\n该 MCP 服务器与 Claude Desktop、Cursor、Windsurf、Cline、Continue 和 Zed 等 AI 助手和开发环境集成，使它们能够通过自然语言交互来搜索和分析互联网连接的设备、服务和漏洞。\n\n## 特征\n\n* 使用 dorks 向 ZoomEye 查询网络资产信息\n* 缓存机制以提高性能并减少 API 调用\n* 失败的 API 请求的自动重试机制\n* 全面的错误处理和日志记录\n\n## 可用工具\n\n* `zoomeye_search` - 根据查询条件获取网络资产信息。\n * 必需参数：\n * `qbase64` （字符串）：用于 ZoomEye 搜索的 Base64 编码查询字符串\n * 可选参数：\n * `page` （整数）：查看资产页码，默认为 1\n * `pagesize` （整数）：每页记录数，默认为10，最大为1000\n * `fields` （字符串）：要返回的字段，以逗号分隔\n * `sub_type` （字符串）：数据类型，支持 v4、v6 和 web。默认为 v4\n * `facets` （字符串）：统计项，如果有多个，则用逗号分隔\n * `ignore_cache` (boolean): 是否忽略缓存\n\n## 使用指南\n\n### 基本用法\n\n服务器运行后，您可以通过 AI 助手或开发环境与其交互。使用方法如下：\n\n1. 使用上述安装方法之一**启动服务器**\n2. **配置您的 AI 助手**（Claude Desktop、Cursor、Windsurf、Cline、Continue、Zed 等）以使用服务器\n3. 使用自然语言**查询网络信息**\n\n![搜索示例](example.png)\n\n### 搜索语法指南\n\n* 搜索范围涵盖设备（IPv4、IPv6）和网站（域）。\n* 当输入搜索字符串时，系统将以“全局”模式匹配关键词，包括HTTP、SSH、FTP等各种协议的内容（例如HTTP/HTTPS协议头、正文、SSL、标题和其他协议横幅）。\n* 搜索字符串不区分大小写，并将进行分段匹配（搜索结果页面提供“分段”测试功能）。使用 == 进行搜索时，会强制使用严格的语法进行精确区分大小写的匹配。\n* 请使用引号括起搜索字符串（例如，“Cisco System”或“Cisco System”）。如果搜索字符串包含引号，请使用转义符，例如，“a”b。如果搜索字符串包含括号，请使用转义符，例如 portinfo()。\n\n您可以在[prompts.py](./src/mcp_server_zoomeye/prompts.py)中看到更详细的搜索语法规则。\n\n有关 ZoomEye Search API 的更多信息，请参阅[ZoomEye API v2 文档](https://www.zoomeye.ai/doc)。\n\n## 入门\n\n### 先决条件\n\n1. **ZoomEye API密钥**\n\n * 在[ZoomEye](https://www.zoomeye.ai/)注册一个账户\n * 从您的帐户设置中获取您的 API 密钥\n * API 密钥将用于验证您对 ZoomEye API 的请求\n\n2. **Python 环境**\n\n * 需要 Python 3.10 或更高版本\n * 或者，您可以使用 Docker 运行服务器，而无需安装 Python\n\n## 安装\n\n### 使用 PIP\n\n或者，您可以通过 pip 安装`mcp-server-zoomeye` ：\n\n```bash\npip install mcp-server-zoomeye\n```\n\n安装后，您可以使用以下命令将其作为脚本运行：\n\n```bash\npython -m mcp_server_zoomeye\n```\n\n### 使用 Docker\n\n您还可以使用 Docker 运行 ZoomEye MCP 服务器：\n\n#### 从 Docker Hub 拉取\n\n```bash\n# Pull the latest image\ndocker pull zoomeyeteam/mcp-server-zoomeye:latest\n\n# Run the container with your API key\ndocker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:latest\n```\n\n> **注意**：我们提供支持`linux/amd64`和`linux/arm64`平台的多架构 Docker 镜像，可以在 Intel/AMD 和 ARM（例如 Apple Silicon）处理器上运行。\n\n#### 从源代码构建\n\n或者，您可以从源代码构建 Docker 镜像：\n\n```bash\n# Clone the repository\ngit clone https://github.com/zoomeye-ai/mcp_zoomeye.git\ncd mcp_zoomeye\n\n# Build the Docker image\ndocker build -t zoomeyeteam/mcp-server-zoomeye:local .\n\n# Run the container\ndocker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:local\n\n```\n\n### 使用 uv\n\n[`uv`](https://docs.astral.sh/uv/)是一个用 Rust 编写的快速 Python 软件包安装程序和解析器。它是 pip 的现代替代品，性能显著提升。\n\n#### 紫外线安装\n\n```bash\n# Install uv using curl (macOS/Linux)\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Or using PowerShell (Windows)\nirm https://astral.sh/uv/install.ps1 | iex\n\n# Or using Homebrew (macOS)\nbrew install uv\n```\n\n#### 使用 uvx 运行 mcp-server-zoomeye\n\n使用[`uvx`](https://docs.astral.sh/uv/guides/tools/)时不需要进行任何特殊安装，它允许您直接运行 Python 包：\n\n#### 使用 uv 安装\n\n或者，您可以使用 uv 安装该包：\n\n```bash\n# Install in the current environment\nuv pip install mcp-server-zoomeye\n\n# Or create and install in a new virtual environment\nuv venv\nuv pip install mcp-server-zoomeye\n```\n\n## 配置\n\n### 环境变量\n\nZoomEye MCP 服务器需要以下环境变量：\n\n* `ZOOMEYE_API_KEY` ：用于身份验证的 ZoomEye API 密钥\n\n您可以通过多种方式设置此环境变量：\n\n1. **在您的 shell 会话中导出**：\n\n ```bash\n export ZOOMEYE_API_KEY=\"your_api_key_here\"\n ```\n\n2. **运行容器时直接传递**（对于Docker）：\n\n ```bash\n docker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:latest\n ```\n\n### 配置 Claude.app\n\n在 Claude 设置中添加以下内容：\n\n```json\n\"mcpServers\": {\n \"zoomeye\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n}\n```\n\n```json\n\"mcpServers\": {\n \"zoomeye\": {\n \"command\": \"docker\",\n \"args\": [\"run\", \"-i\", \"--rm\", \"-e\", \"ZOOMEYE_API_KEY=your_api_key_here\", \"zoomeyeteam/mcp-server-zoomeye:latest\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n}\n```\n\n```json\n\"mcpServers\": {\n \"zoomeye\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"mcp_server_zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n}\n```\n\n### 配置 Zed\n\n在 Zed 的 settings.json 中添加以下内容：\n\n```json\n\"context_servers\": [\n \"mcp-server-zoomeye\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n],\n```\n\n```json\n\"context_servers\": {\n \"mcp-server-zoomeye\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"mcp_server_zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n},\n```\n\n## 交互示例\n\n### 示例 1：检索全局 Apache Tomcat 资产\n\n```json\n{\n \"name\": \"zoomeye_search\",\n \"arguments\": {\n \"qbase64\": \"app=\\\"Apache Tomcat\\\"\"\n }\n}\n```\n\n回复：\n\n```json\n{\n \"code\": 60000,\n \"message\": \"success\",\n \"total\": 163139107,\n \"query\": \"title=\\\"cisco vpn\\\"\",\n \"data\": [\n {\n \"url\": \"https://1.1.1.1:443\",\n \"ssl.jarm\": \"29d29d15d29d29d00029d29d29d29dea0f89a2e5fb09e4d8e099befed92cfa\",\n \"ssl.ja3s\": \"45094d08156d110d8ee97b204143db14\",\n \"iconhash_md5\": \"f3418a443e7d841097c714d69ec4bcb8\",\n \"robots_md5\": \"0b5ce08db7fb8fffe4e14d05588d49d9\",\n \"security_md5\": \"0b5ce08db7fb8fffe4e14d05588d49d9\",\n \"ip\": \"1.1.1.1\",\n \"domain\": \"www.google.com\",\n \"hostname\": \"SPACEX\",\n \"os\": \"windows\",\n \"port\": 443,\n \"service\": \"https\",\n \"title\": [\"GoogleGoogle appsGoogle Search\"],\n \"version\": \"1.1.0\",\n \"device\": \"webcam\",\n \"rdns\": \"c01031-001.cust.wallcloud.ch\",\n \"product\": \"OpenSSD\",\n \"header\": \"HTTP/1.1 302 Found Location: https://www.google.com/?gws_rd=ssl Cache-Control: private...\",\n \"header_hash\": \"27f9973fe57298c3b63919259877a84d\",\n \"body\": \"HTTP/1.1 302 Found Location: https://www.google.com/?gws_rd=ssl Cache-Control: private...\",\n \"body_hash\": \"84a18166fde3ee7e7c974b8d1e7e21b4\",\n \"banner\": \"SSH-2.0-OpenSSH_7.6p1 Ubuntu-4ubuntu0.3\",\n \"update_time\": \"2024-07-03T14:34:10\",\n \"header.server.name\": \"nginx\",\n \"header.server.version\": \"1.8.1\",\n \"continent.name\": \"Europe\",\n \"country.name\": \"Germany\",\n \"province.name\": \"Hesse\",\n \"city.name\": \"Frankfurt\",\n \"lon\": \"118.753262\",\n \"lat\": \"32.064838\",\n \"isp.name\": \"aviel.ru\",\n \"organization.name\": \"SERVISFIRST BANK\",\n \"zipcode\": \"210003\",\n \"idc\": 0,\n \"honeypot\": 0,\n \"asn\": 4837,\n \"protocol\": \"tcp\",\n \"ssl\": \"SSL Certificate Version: TLS 1.2 CipherSuit: TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256...\",\n \"primary_industry\": \"Finance\",\n \"sub_industry\": \"bank\",\n \"rank\": 60\n }\n ]\n}\n```\n\n## 调试和故障排除\n\n### 使用 MCP 检查器\n\n模型上下文协议检查器是一款通过模拟客户端交互来帮助调试 MCP 服务器的工具。您可以使用它来测试您的 ZoomEye MCP 服务器：\n\n```bash\n# For uvx installation\nnpx @modelcontextprotocol/inspector uvx mcp-server-zoomeye\n\n# If developing locally\ncd path/to/servers/src/mcp_server_zoomeye\nnpx @modelcontextprotocol/inspector uv run mcp-server-zoomeye\n```\n\n### 常见问题\n\n1. **身份验证错误**\n\n * 确保您的 ZoomEye API 密钥正确并正确设置为环境变量\n * 检查您的 API 密钥是否已过期或被撤销\n\n2. **连接问题**\n\n * 验证您的互联网连接\n * 检查 ZoomEye API 是否正在停机\n\n3. **没有结果**\n\n * 您的查询可能过于具体或包含语法错误\n * 尝试简化您的查询或使用不同的搜索词\n\n4. **速率限制**\n\n * ZoomEye API 根据您的帐户类型具有速率限制\n * 分散您的请求或升级您的帐户以获得更高的限额\n\n## 高级用法\n\n### 缓存\n\nZoomEye MCP 服务器实现了缓存，以提高性能并减少 API 调用：\n\n* 根据查询参数缓存响应\n* 缓存时长可配置（默认值：1小时）\n* 您可以通过在查询中将`ignore_cache`设置为`true`来绕过缓存\n\n### 自定义字段\n\n您可以使用`fields`参数请求查询结果中的特定字段：\n\n```json\n{\n \"name\": \"zoomeye_search\",\n \"arguments\": {\n \"qbase64\": \"app=\\\"Apache\\\"\",\n \"fields\": \"ip,port,domain,service,os,country,city\"\n }\n}\n```\n\n### 分页\n\n对于返回许多结果的查询，您可以对它们进行分页：\n\n```json\n{\n \"name\": \"zoomeye_search\",\n \"arguments\": {\n \"qbase64\": \"app=\\\"Apache\\\"\",\n \"page\": 2,\n \"pagesize\": 20\n }\n}\n```\n\n## 贡献\n\n我们鼓励大家为 mcp-server-zoomeye 贡献力量，以扩展和改进其功能。无论是添加新的相关工具、增强现有功能，还是改进文档，您的贡献都弥足珍贵。\n\n有关其他 MCP 服务器和实现模式的示例，请参阅： \n\n欢迎提交 Pull 请求！欢迎贡献新想法、错误修复或功能增强，使 mcp-server-zoomeye 更加健壮实用。\n\n## 执照\n\nmcp-server-zoomeye 采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多信息，请参阅项目仓库中的 LICENSE 文件。","Chinese","zh-CN","githubUser","locale",{"_71":72,"_73":74,"_13":85,"_96":32,"_97":32,"_98":99,"_103":104,"_125":-5,"_16":126,"_127":128,"_129":130,"_33":34,"_155":117,"_156":-5,"_157":-5,"_158":159,"_160":-5,"_161":162,"_168":-5,"_137":113,"_169":170,"_174":175,"_118":237,"_238":239},"addedAt","2025-03-18T04:55:53.616616352Z","argumentsJsonSchema",{"_75":76,"_82":83,"_80":84},"properties",{"_77":78},"ZOOMEYE_API_KEY",{"_31":79,"_80":81},"Your ZoomEye API key for authentication","type","string","required",[77],"object",[86,87,88,89,90,91,92,93,94,95],"author:official","category:search","category:security-and-iam","category:developer-tools","environment:network","hosting:hybrid","language:python","security_grade:a","quality_grade:a","license_grade:f","descriptionMarkdown","descriptionPlainText","githubProject",{"_35":100,"_101":102},"# 🚀 ZoomEye MCP Server\n\nA Model Context Protocol (MCP) server that provides network asset information based on query conditions. This server allows Large Language Models (LLMs) to obtain network asset information by querying ZoomEye using dorks and other search parameters.\n\n## 🔔 Announcement\n\n🎉 We are excited to announce the official open-source release of **ZoomEye MCP Server** — a powerful Model Context Protocol (MCP) server that brings real-time cyber asset intelligence to AI assistants and development environments.\n\n🚀 Free Trial: 7-Day FREE Access to ZoomEye MCP!\nExperience ZoomEye MCP — the AI-powered cyberspace asset search engine — absolutely free for 7 days!\n\n🔍 Search global internet assets, track real-time changes, and unlock AI-driven insights — all in one place.\n\n👉 How to claim:\n\n1. Follow us on Twitter: [@zoomeye_team](https://x.com/zoomeye_team)\n2. DM us \"MCP\" and your MCP setup screenshot\n3. Get instant access to your 7-day membership\n\n🎁 Limited-time free trial — explore the power of AI asset search today!\n\n💡 Provide insightful feedback that gets officially adopted, and you'll unlock **even more rewards**!\n\n🔧 Fully compatible with leading MCP environments:\n\n- Claude Desktop\n- Cursor\n- Windsurf\n- Cline\n- Continue\n- Zed\n- Cherry Studio\n- Chatbox\n\n🔗 Explore ZoomEye MCP Server on:\n\n- GitHub: [zoomeye-ai/mcp_zoomeye](https://github.com/zoomeye-ai/mcp_zoomeye)\n- MCP.so: [mcp.so/server/mcp_zoomeye](https://mcp.so/server/mcp_zoomeye/zoomeye-ai)\n- Smithery: [smithery.ai/server/@zoomeye-ai/mcp_zoomeye](https://smithery.ai/server/@zoomeye-ai/mcp_zoomeye)\n- Cursor Directory: [cursor.directory/mcp/zoomeye](https://cursor.directory/mcp/zoomeye)\n- Pulse MCP: [pulsemcp.com/servers/zoomeye](https://www.pulsemcp.com/servers/zoomeye)\n- Glama MCP: [glama.ai/mcp/servers](https://glama.ai/mcp/servers)\n\nWe welcome everyone to use, explore, and contribute!\n\n## 🔑 How can I get a ZoomEye API key?\n\nTo use this MCP server, you’ll need a ZoomEye API key.\n\n1. Go to https://www.zoomeye.ai\n2. Register or log in\n3. Click your avatar → **Profile**\n4. Copy your **API-KEY**\n5. Set the environment variable:\n \n `export ZOOMEYE_API_KEY=\"your_api_key_here\"`\n\n![zoomeye1](./zoomeye1.jpg)\n\n![zoomeye2](./zoomeye2.jpg)\n\n## Features\n\n- Query ZoomEye for network asset information using dorks\n- Caching mechanism to improve performance and reduce API calls\n- Automatic retry mechanism for failed API requests\n- Comprehensive error handling and logging\n\n## Available Tools\n\n- `zoomeye_search` - Get network asset information based on query conditions.\n - Required parameters:\n - `qbase64` (string): Base64 encoded query string for ZoomEye search\n - Optional parameters:\n - `page` (integer): View asset page number, default is 1\n - `pagesize` (integer): Number of records per page, default is 10, maximum is 1000\n - `fields` (string): The fields to return, separated by commas\n - `sub_type` (string): Data type, supports v4, v6, and web. Default is v4\n - `facets` (string): Statistical items, separated by commas if there are multiple\n - `ignore_cache` (boolean): Whether to ignore the cache\n\n## Usage Guide\n\n### Basic Usage\n\nOnce the server is running, you can interact with it through your AI assistant or development environment. Here's how to use it:\n\n1. **Start the server** using one of the installation methods above\n2. **Configure your AI assistant** (Claude Desktop, Cursor, Windsurf, Cline, Continue, Zed, etc.) to use the server\n3. **Query network information** using natural language\n\n![searchexample](example.png)\n\n### Search Syntax Guide\n\n- Search Scope covers devices (IPv4, IPv6) and websites (domains).\n- When entering a search string, the system will match keywords in \"global\" mode, including content from various\n protocols such as HTTP, SSH, FTP, etc. (e.g., HTTP/HTTPS protocol headers, body, SSL, title, and other protocol\n banners).\n- Search strings are case-insensitive and will be segmented for matching (the search results page provides a \"\n segmentation\" test feature). When using == for search, it enforces exact case-sensitive matching with strict syntax.\n- Please use quotes for search strings (e.g., \"Cisco System\" or 'Cisco System'). If the search string contains quotes,\n use the escape character, e.g.,\"a\\\"b\". If the search string contains parentheses, use the escape character, e.g.,\n portinfo\\(\\).\n\nYou can see more detailed search syntax rules in [prompts.py](./src/mcp_server_zoomeye/prompts.py).\n\nFor more information on the ZoomEye Search API, refer to the [ZoomEye API v2 documentation](https://www.zoomeye.ai/doc).\n\n## Getting Started\n\n### Prerequisites\n\n1. **ZoomEye API Key**\n \n - Register for an account at [ZoomEye](https://www.zoomeye.ai/)\n - Obtain your API key from your account settings\n - The API key will be used to authenticate your requests to the ZoomEye API\n2. **Python Environment**\n \n - Python 3.10 or higher is required\n - Alternatively, you can use Docker to run the server without installing Python\n\n## Installation\n\n### Using PIP\n\nAlternatively, you can install `mcp-server-zoomeye` via pip:\n\n```bash\npip install mcp-server-zoomeye\n```\n\nAfter installation, you can run it as a script using the following command:\n\n```bash\npython -m mcp_server_zoomeye\n```\n\n### Using Docker\n\nYou can also run the ZoomEye MCP server using Docker:\n\n#### Pull from Docker Hub\n\n```bash\n# Pull the latest image\ndocker pull zoomeyeteam/mcp-server-zoomeye:latest\n\n# Run the container with your API key\ndocker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:latest\n```\n\n> **Note**: We provide multi-architecture Docker images that support `linux/amd64` and `linux/arm64` platforms and can run on Intel/AMD and ARM (such as Apple Silicon) processors.\n\n#### Build from Source\n\nAlternatively, you can build the Docker image from source:\n\n```bash\n# Clone the repository\ngit clone https://github.com/zoomeye-ai/mcp_zoomeye.git\ncd mcp_zoomeye\n\n# Build the Docker image\ndocker build -t zoomeyeteam/mcp-server-zoomeye:local .\n\n# Run the container\ndocker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:local\n```\n\n### Using uv\n\n[`uv`](https://docs.astral.sh/uv/) is a fast Python package installer and resolver written in Rust. It's a modern alternative to pip that offers significant performance improvements.\n\n#### Installation of uv\n\n```bash\n# Install uv using curl (macOS/Linux)\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Or using PowerShell (Windows)\nirm https://astral.sh/uv/install.ps1 | iex\n\n# Or using Homebrew (macOS)\nbrew install uv\n```\n\n#### Using uvx to run mcp-server-zoomeye\n\nNo specific installation is required when using [`uvx`](https://docs.astral.sh/uv/guides/tools/), which allows you to run Python packages directly:\n\n#### Installing with uv\n\nAlternatively, you can install the package using uv:\n\n```bash\n# Install in the current environment\nuv pip install mcp-server-zoomeye\n\n# Or create and install in a new virtual environment\nuv venv\nuv pip install mcp-server-zoomeye\n```\n\n## Configuration\n\n### Environment Variables\n\nThe ZoomEye MCP server requires the following environment variable:\n\n- `ZOOMEYE_API_KEY`: Your ZoomEye API key for authentication\n\nYou can set this environment variable in several ways:\n\n1. **Export in your shell session**:\n \n ```bash\n export ZOOMEYE_API_KEY=\"your_api_key_here\"\n ```\n2. **Pass directly when running the container** (for Docker):\n \n ```bash\n docker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:latest\n ```\n\n### Configure Claude.app\n\nAdd the following in Claude settings:\n\n

Using uvx

\n\n```json\n\"mcpServers\": {\n \"zoomeye\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-zoomeye\"],\n \"env\": {\n \"ZOOMEYE_API_KEY\": \"your_api_key_here\"\n }\n }\n}\n```\n\n

\n\n

Using docker

\n\n

Installed via pip

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

\n\n### Configure Zed\n\nAdd the following in Zed's settings.json:\n\n

Using uvx

\n\n

Installed via pip

\n\n## Example Interactions\n\n### Example 1: Retrieve global Apache Tomcat assets\n\n```json\n{\n \"name\": \"zoomeye_search\",\n \"arguments\": {\n \"qbase64\": \"app=\\\"Apache Tomcat\\\"\"\n }\n}\n```\n\nResponse:\n\n```json\n{\n \"code\": 60000,\n \"message\": \"success\",\n \"total\": 163139107,\n \"query\": \"app=\\\"Apache Tomcat\\\"\",\n \"data\": [\n {\n \"url\": \"https://1.1.1.1:443\",\n \"ssl.jarm\": \"29d29d15d29d29d00029d29d29d29dea0f89a2e5fb09e4d8e099befed92cfa\",\n \"ssl.ja3s\": \"45094d08156d110d8ee97b204143db14\",\n \"iconhash_md5\": \"f3418a443e7d841097c714d69ec4bcb8\",\n \"robots_md5\": \"0b5ce08db7fb8fffe4e14d05588d49d9\",\n \"security_md5\": \"0b5ce08db7fb8fffe4e14d05588d49d9\",\n \"ip\": \"1.1.1.1\",\n \"domain\": \"www.google.com\",\n \"hostname\": \"SPACEX\",\n \"os\": \"windows\",\n \"port\": 443,\n \"service\": \"https\",\n \"title\": [\"GoogleGoogle appsGoogle Search\"],\n \"version\": \"1.1.0\",\n \"device\": \"webcam\",\n \"rdns\": \"c01031-001.cust.wallcloud.ch\",\n \"product\": \"OpenSSD\",\n \"header\": \"HTTP/1.1 302 Found Location: https://www.google.com/?gws_rd=ssl Cache-Control: private...\",\n \"header_hash\": \"27f9973fe57298c3b63919259877a84d\",\n \"body\": \"HTTP/1.1 302 Found Location: https://www.google.com/?gws_rd=ssl Cache-Control: private...\",\n \"body_hash\": \"84a18166fde3ee7e7c974b8d1e7e21b4\",\n \"banner\": \"SSH-2.0-OpenSSH_7.6p1 Ubuntu-4ubuntu0.3\",\n \"update_time\": \"2024-07-03T14:34:10\",\n \"header.server.name\": \"nginx\",\n \"header.server.version\": \"1.8.1\",\n \"continent.name\": \"Europe\",\n \"country.name\": \"Germany\",\n \"province.name\": \"Hesse\",\n \"city.name\": \"Frankfurt\",\n \"lon\": \"118.753262\",\n \"lat\": \"32.064838\",\n \"isp.name\": \"aviel.ru\",\n \"organization.name\": \"SERVISFIRST BANK\",\n \"zipcode\": \"210003\",\n \"idc\": 0,\n \"honeypot\": 0,\n \"asn\": 4837,\n \"protocol\": \"tcp\",\n \"ssl\": \"SSL Certificate Version: TLS 1.2 CipherSuit: TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256...\",\n \"primary_industry\": \"Finance\",\n \"sub_industry\": \"bank\",\n \"rank\": 60\n }\n ]\n}\n```\n\n## Debugging and Troubleshooting\n\n### Using MCP Inspector\n\nThe Model Context Protocol Inspector is a tool that helps debug MCP servers by simulating client interactions. You can use it to test your ZoomEye MCP server:\n\n```bash\n# For uvx installation\nnpx @modelcontextprotocol/inspector uvx mcp-server-zoomeye\n\n# If developing locally\ncd path/to/servers/src/mcp_server_zoomeye\nnpx @modelcontextprotocol/inspector uv run mcp-server-zoomeye\n```\n\n### Common Issues\n\n1. **Authentication Errors**\n \n - Ensure your ZoomEye API key is correct and properly set as an environment variable\n - Check that your API key has not expired or been revoked\n2. **Connection Issues**\n \n - Verify your internet connection\n - Check if the ZoomEye API is experiencing downtime\n3. **No Results**\n \n - Your query might be too specific or contain syntax errors\n - Try simplifying your query or using different search terms\n4. **Rate Limiting**\n \n - ZoomEye API has rate limits based on your account type\n - Space out your requests or upgrade your account for higher limits\n\n## Advanced Usage\n\n### Caching\n\nThe ZoomEye MCP server implements caching to improve performance and reduce API calls:\n\n- Responses are cached based on the query parameters\n- Cache duration is configurable (default: 1 hour)\n- You can bypass the cache by setting `ignore_cache` to `true` in your query\n\n### Custom Fields\n\nYou can request specific fields in your query results by using the `fields` parameter:\n\n```json\n{\n \"name\": \"zoomeye_search\",\n \"arguments\": {\n \"qbase64\": \"app=\\\"Apache\\\"\",\n \"fields\": \"ip,port,domain,service,os,country,city\"\n }\n}\n```\n\n### Pagination\n\nFor queries that return many results, you can paginate through them:\n\n```json\n{\n \"name\": \"zoomeye_search\",\n \"arguments\": {\n \"qbase64\": \"app=\\\"Apache\\\"\",\n \"page\": 2,\n \"pagesize\": 20\n }\n}\n```\n\n## Contributing\n\nWe encourage contributions to mcp-server-zoomeye to help expand and improve its functionality. Whether it's adding new related tools, enhancing existing features, or improving documentation, your input is valuable.\n\nFor examples of other MCP servers and implementation patterns, see:\nhttps://github.com/modelcontextprotocol/servers\n\nPull requests are welcome! Feel free to contribute new ideas, bug fixes, or enhancements to make mcp-server-zoomeye more robust and practical.\n\n## License\n\nmcp-server-zoomeye is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more information, see the LICENSE file in the project repository.","url","https://github.com/zoomeye-ai/mcp_zoomeye","githubRepository",{"_105":106,"_107":108,"_109":110,"_111":112,"_33":113,"_114":115,"_120":121,"_122":-5,"_123":124},"defaultBranch","main","fullName","zoomeye-ai/mcp_zoomeye","githubTreeId",133706,"language","Python","mcp_zoomeye","owner",{"_116":117,"_118":119},"login","zoomeye-ai","uid","NfbN07lHdO","recentStargazers",2,"spdxLicense","stargazers",32,"glamaJson",1925,"inspectable",true,"integrations",[131,141,148],{"_132":133,"_31":139,"_118":140},"brand",{"_134":135,"_33":136,"_137":138},"logoSvgPath","M12.66 3.494c-.377.637-.544 2.114-.502 3.162l-.005.004c.036.946.165 1.816.372 2.615-3.096.767-6.466 2.795-8.352 4.754-.882-1.19-1.232-2.168-1.336-2.908-.131-.936.092-1.794.646-2.482.867-1.077 2.098-1.153 3.365-.94-.025.2.001.391.081.51.335.494 2.135.668 3.21.189-.793-1.112-2.4-1.654-2.844-1.437a.762.762 0 00-.335.359c-.438-.078-.873-.137-1.19-.134-1.117.008-1.971.398-2.61 1.193-.628.78-.882 1.747-.734 2.8.14.996.633 2.055 1.46 3.154-.138.147-.27.293-.398.436C1.473 17.023 0 19.44 0 19.842v.207h2.658l-.046-.246c-.15-.793.15-1.785.763-2.526.386-.465 1.024-.996 2.027-1.241.891.87 2.027 1.794 3.291 2.685h1.976v-.208a.678.678 0 00-.327-.577c-.312-.204-.794-.232-1.237-.081-.421-.47-.658-1.098-.709-1.877 4.287.38 8.388 2.11 13.015 4.528h2.546l.033-.167c.048-.237-.082-.556-.346-.851-.456-.51-1.349-.752-2.095-.734-.514-.612-3.342-3.591-3.507-3.765a9.626 9.626 0 002.673-2.847h1.388v-.298H20.89a9.81 9.81 0 00.223-.419h.989v-.299h-.845c.628-1.359.975-2.918.942-4.625l.003.002c-.002-.468-.147-2.445-.415-2.989-.726.276-2.047 1.17-2.346 2.084a14.557 14.557 0 00-4.463.056c-.237-.984-1.423-1.736-2.318-2.16zm.164.577c.211 1.148.593 1.869 1.42 2.223.734-.21 1.58-.34 2.448-.388l.717 1.571.46-1.585c.876.029 1.736.142 2.485.349.762-.554 1.057-1.4 1.218-2.138.202.86.178 2.717.18 2.717a9.883 9.883 0 01-.158 1.988l-.824.35.726.11a9.19 9.19 0 01-.198.714l-.703.205.56.201c-.094.253-.2.5-.314.738h-1.16v.299h1.008a8.788 8.788 0 01-.238.419h-.77v.298h.583a8.634 8.634 0 01-2.921 2.748c-1.334-.664-2.341-1.634-3.079-2.748h.446v-.298h-.636a9.195 9.195 0 01-.236-.419h.872v-.299h-1.026a10.12 10.12 0 01-.46-1.094l.522-.147-.659-.263c-.066-.215-.127-.43-.18-.646l1.015-.069-1.16-.615c-.282-1.563-.225-3.08.062-4.221zm2.946 2.97c-.89 0-1.24.909-1.255.948l.252.094c.012-.033.302-.773 1.003-.773.154 0 .262.062.34.195.182.314.152.933 0 1.58h-1.227v.269h1.159a5.679 5.679 0 01-.496 1.225l-.064.112 1.537.967-.865.57.148.224.967-.637 1.043.681.143-.228-.967-.598 1.518-.986v-.001c-.318-.47-.42-.872-.286-1.329h.108l1.167-.001.002-.268h-1.175c.216-.51.52-.968 1.602-.968v-.27c-.999 0-1.596.397-1.883 1.238h-2.154c.15-.672.177-1.333-.046-1.715a.63.63 0 00-.57-.33zm.55 2.313h2.126c-.095.304-.057.763.178 1.157h-2.737c.166-.334.32-.74.433-1.157zm-3.683.321c.155.515.344.997.562 1.451h-.91v.299h1.06c.075.142.153.282.233.419H12.29v.298h1.478c.91 1.416 2.14 2.499 3.534 3.318a9.45 9.45 0 00.456-.28l.362.39-.61.938 1.04-.474.606.652-1.019.776 1.403-.363 1.905 2.05.16-.014c1.007-.086 1.58.46 1.73.63.112.124.179.237.215.326h-2.036c-4.67-2.437-8.771-4.155-13.127-4.53.01-.607.117-1.293.324-2.058l-.4-.108c-.213.786-.325 1.497-.338 2.134-.454-.03-.91-.046-1.371-.046-.391 0-.747.036-1.072.1a14.771 14.771 0 01-1.09-1.21c.546-.57 1.19-1.123 1.893-1.643l.967.668-.316-1.128c.297-.2.603-.394.914-.58l1.434.73-.673-1.162c.198-.106.398-.21.598-.31l2.007 1.346-.66-1.952a15.32 15.32 0 012.034-.667zm3.492 1.105h2.22l-1.084.715zM4.153 14.675c.273.337.577.678.91 1.021a4.104 4.104 0 00-2.007 1.316c-.629.76-.962 1.762-.886 2.622H.495c.337-.728 1.677-2.833 3.658-4.959z","Apache Tomcat","slug","apache-tomcat","Allows querying for Apache Tomcat assets across the internet, with the ability to retrieve detailed information about deployed instances.","xs912409qg",{"_132":142,"_31":146,"_118":147},{"_134":143,"_33":144,"_137":145},"M16.331 18.171V17.06l-.022.01c-.25.121-.522.19-.801.203a1.186 1.186 0 01-.806-.237 1.038 1.038 0 01-.352-.498 1.21 1.21 0 01-.023-.667c.052-.225.178-.426.357-.569.16-.134.355-.218.562-.242a1.85 1.85 0 011.061.198l.024.013v-1.117l-.051-.014a2.862 2.862 0 00-1.011-.132 2.34 2.34 0 00-.903.206c-.287.132-.54.327-.739.571a2.221 2.221 0 00-.04 2.705c.295.378.709.645 1.175.756.491.12 1.006.102 1.487-.052l.082-.023M5.336 18.171V17.06l-.022.01c-.25.121-.522.19-.801.203a1.183 1.183 0 01-.806-.237 1.03 1.03 0 01-.351-.498 1.202 1.202 0 01-.024-.667c.052-.225.177-.426.357-.569.16-.134.355-.218.562-.242a1.85 1.85 0 011.061.198l.024.013v-1.117l-.051-.014a2.862 2.862 0 00-1.011-.132 2.344 2.344 0 00-.903.206 2.08 2.08 0 00-.74.571 2.224 2.224 0 00-.041 2.705 2.11 2.11 0 001.176.756c.491.12 1.005.102 1.487-.052l.083-.023M9.26 17.249l-.004.957.07.012c.22.041.441.069.664.085.195.019.391.022.587.012.187-.014.372-.049.551-.104.21-.06.405-.163.571-.305a1.16 1.16 0 00.333-.478 1.31 1.31 0 00-.007-.96 1.068 1.068 0 00-.298-.414 1.261 1.261 0 00-.438-.255l-.722-.268a.388.388 0 01-.197-.188.245.245 0 01.008-.219.382.382 0 01.154-.142.798.798 0 01.257-.074c.153-.022.308-.021.46.005.18.02.358.051.533.096l.038.008v-.883l-.069-.015a4.749 4.749 0 00-.543-.097 2.844 2.844 0 00-.714-.003c-.3.027-.585.143-.821.33-.16.126-.281.293-.351.484-.104.29-.105.608 0 .899.054.145.14.274.252.381.097.093.207.173.327.236.157.084.324.149.497.195.057.017.114.035.17.054l.085.031.024.01c.084.03.162.078.226.14.045.042.08.094.101.151a.325.325 0 01.001.161.339.339 0 01-.166.198.856.856 0 01-.275.086 2.032 2.032 0 01-.427.021 5.208 5.208 0 01-.557-.074 9.195 9.195 0 01-.287-.067l-.033-.006zm-2.475.995h1.05v-4.167h-1.05v4.167zm12.162-2.936a1.095 1.095 0 011.541.158 1.094 1.094 0 01-.157 1.541l-.017.014a1.096 1.096 0 01-1.367-1.713m-1.525.854a2.193 2.193 0 002.666 2.107 2.139 2.139 0 00.701-3.937 2.207 2.207 0 00-3.367 1.83M22.961 10.728a.52.52 0 001.039 0V9.573a.52.52 0 00-1.039 0v1.155M20.117 10.728a.522.522 0 001.041 0V8.139a.521.521 0 00-1.04 0v2.589M17.231 11.771a.521.521 0 001.039 0V6.17a.52.52 0 00-1.039 0v5.601M14.393 10.728a.521.521 0 001.04 0V8.139a.52.52 0 00-1.039 0v2.589M11.494 10.728a.522.522 0 001.039 0V9.573a.52.52 0 00-1.039 0v1.155M8.624 10.728a.52.52 0 001.039 0V8.139a.52.52 0 00-1.039 0v2.589M5.737 11.771a.52.52 0 001.039 0V6.17a.52.52 0 00-1.039 0v5.601M2.876 10.728a.522.522 0 001.04 0V8.139a.52.52 0 00-1.039 0v2.589M0 10.728a.521.521 0 001.039 0V9.573a.52.52 0 00-1.039 0v1.155","Cisco","cisco","Enables searching for Cisco VPN deployments and related network assets, providing detailed SSL, security, and configuration information.","hek2oqlsf9",{"_132":149,"_31":153,"_118":154},{"_134":150,"_33":151,"_137":152},"M12 0L1.605 6v12L12 24l10.395-6V6L12 0zm6 16.59c0 .705-.646 1.29-1.529 1.29-.631 0-1.351-.255-1.801-.81l-6-7.141v6.66c0 .721-.57 1.29-1.274 1.29H7.32c-.721 0-1.29-.6-1.29-1.29V7.41c0-.705.63-1.29 1.5-1.29.646 0 1.38.255 1.83.81l5.97 7.141V7.41c0-.721.6-1.29 1.29-1.29h.075c.72 0 1.29.6 1.29 1.29v9.18H18z","NGINX","nginx","Supports discovering NGINX web servers across the internet, retrieving server version, configuration, and deployment details.","gjn0vaf2mp","namespace","npmPackage","prompts","redditPostForeignId","1jdxhj2","resources","scores",{"_163":164,"_165":166,"_167":166},"license",0,"quality",100,"security","simpleIcon","supportedPlatforms",[171,172,173],"WINDOWS","LINUX","MACOS","tools",[176,216,225],{"_33":177,"_31":178,"_179":180},"zoomeye_search","\n### Search Syntax Guide\n\n- Search Scope covers devices (IPv4, IPv6) and websites (domains).\n- When entering a search string, the system will match keywords in \"global\" mode, including content from various\n protocols such as HTTP, SSH, FTP, etc. (e.g., HTTP/HTTPS protocol headers, body, SSL, title, and other protocol\n banners).\n- Search strings are case-insensitive and will be segmented for matching (the search results page provides a \"\n segmentation\" test feature). When using == for search, it enforces exact case-sensitive matching with strict syntax.\n- Please use quotes for search strings (e.g., \"Cisco System\" or 'Cisco System'). If the search string contains quotes,\n use the escape character, e.g.,\"a\"b\". If the search string contains parentheses, use the escape character, e.g.,\n portinfo\\(\\).\n\n### The logical operators of the syntax：\n\n- =， Search for assets containing keywords\n title=\"knownsec\"\n Search for websites with titles containing Knownsec's assets\n- ==， Accurate search, indicating a complete match of keywords (case sensitive), can search for data with empty values\n title==\"knownsec\"\n Precise search, which means exact match of keywords (case sensitive), and can search for data with empty values Search\n for assets with the website title \"Knownsec\"\n- ||， Enter \"||\" in the search box to indicate the logical operation of \"or\"\n service=\"ssh\" || service=\"http\"\n Search for SSH or HTTP data\n- &&， Enter \"&&\" in the search box to indicate the logical operation of \"and\"\n device=\"router\" && after=\"2020-01-01\"\n Search for routers after Jan 1, 2020\n- !=， Enter \"!=\" in the search box to indicate the logical operation of \"not\"\n country=\"US\" && subdivisions!=\"new york\"\n Search for data in united states excluding new york\n- ()， Enter \"()\" in the search box to indicate the logical operation of \"priority processing\"\n (country=\"US\" && port!=80) || (country=\"US\" && title!=\"404 Not Found\")\n Search excluding port 80 in US or \"404 not found\" in the US\n- *，Fuzzy search, use * for search\n title=\"*google\"\n Fuzzy search, use * to search Search for assets containing Knowsec in the website title, and the title can start with\n any character\n\n### Grammatical keywords\n\n#### Geographical Location Search\n\n- country=\"CN\" Search for country assets\n Input country abbreviations or names, e.g.\n country=\"china\"\n- subdivisions=\"beijing\" Search for assets in the specified administrative region\n Input in English, e.g.\n subdivisions=\"beijing\"\n- city=\"changsha\" Search for city assets\n Input in English, e.g.\n city=\"changsha\"\n\n#### Certificate Search\n\n- ssl=\"google\" Search for assets with \"google\" string in ssl certificate Often used to search for corresponding\n targets by product name and company name\n- ssl.cert.fingerprint=\"F3C98F223D82CC41CF83D94671CCC6C69873FABF\" Search for certificate-related fingerprint assets\n- ssl.chain_count=3 Search for SSL chain count assets\n- ssl.cert.alg=\"SHA256-RSA\" Search for signature algorithms supported by certificates\n- ssl.cert.issuer.cn=\"pbx.wildix.com\" Search for the common domain name of the user certificate issuer\n- ssl.cert.pubkey.rsa.bits=2048 Search for rsa_bits certificate public key bit number\n- ssl.cert.pubkey.ecdsa.bits=256 Search for ecdsa_bits certificate public key bit number\n- ssl.cert.pubkey.type=\"RSA\" Search for the public key type of the certificate\n- ssl.cert.serial=\"18460192207935675900910674501\" Search for certificate serial number\n- ssl.cipher.bits=\"128\" Search for encryption suite bit number\n- ssl.cipher.name=\"TLS_AES_128_GCM_SHA256\" Search for encryption suite name\n- ssl.cipher.version=\"TLSv1.3\" Search for encryption suite version\n- ssl.version=\"TLSv1.3\" Search for the SSL version of the certificate\n- ssl.cert.subject.cn=\"example.com\" Search for the common domain name of the user certificate holder\n- ssl.jarm=\"29d29d15d29d29d00029d29d29d29dea0f89a2e5fb09e4d8e099befed92cfa\" Search for assets related to Jarm\n Fingerprint content\n- ssl.ja3s=45094d08156d110d8ee97b204143db14 Find assets related to specific JA3S fingerprints\n\n#### IP or Domain Name Related Information Search\n\n- ip=\"8.8.8.8\" Search for assets related to the specified IPv4 address\n ip=\"2600:3c00::f03c:91ff:fefc:574a\" Search for assets related to specified IPv6 address\n- cidr=\"52.2.254.36/24\" Search for C-class assets of IP\n cidr=\"52.2.254.36/16\"is the B class of the IP, cidr=\"52.2.254.36/8\"is the A class of the IP, e.g.\n cidr=\"52.2.254.36/16\"\n cidr=\"52.2.254.36/8\"\n- org=\"Stanford University\" Search for assets of related organizations Used to locate IP assets corresponding to\n universities, structures, and large Internet companies\n- isp=\"China Mobile\" Search for assets of related network service providers Can be supplemented with org data\n- asn=42893 Search for IP assets related to corresponding ASN (Autonomous system number)\n- port=80 Search for related port assets Currently does not support simultaneous open multi-port target search\n- hostname=\"google.com\" Search for assets of related IP \"hostname\"\n- domain=\"baidu.com\" Search for domain-related assets Used to search domain and subdomain data\n\n- banner=\"FTP\" Search by protocol messages Used for searching HTTP response header data\n- http.header=\"http\" Search by HTTP response header Used for searching HTTP response header data\n- http.header_hash=\"27f9973fe57298c3b63919259877a84d\" Search by the hash values calculated from HTTP header.\n- http.header.server=\"Nginx\" Search by server of the HTTP header Used for searching the server data in HTTP response\n headers\n- http.header.version=\"1.2\" Search by version number in the HTTP header\n- http.header.status_code=\"200\" Search by HTTP response status code Search for assets with HTTP response status code\n 200 or other status codes, such as 302, 404, etc.\n- http.body=\"document\" Search by HTML body\n- http.body_hash=\"84a18166fde3ee7e7c974b8d1e7e21b4\" Search by hash value calculated from HTML body\n\n#### Fingerprint Search\n\n- app=\"Cisco ASA SSL VPN\" Search for Cisco ASA-SSL-VPN devices For more app rules, please refer to [object Object].\n Entering keywords such as \"Cisco\" in the search box will display related app prompts\n- service=\"ssh\" Search for assets related to the specified service protocol Common service protocols include: http,\n ftp,\n ssh, telnet, etc. (other services can be found in the domain name sidebar aggregation display of search results)\n- device=\"router\" Search for router-related device types Common types include router, switch, storage-misc, etc. (other\n types can be found in the domain name sidebar aggregation display of search results)\n- os=\"RouterOS\" Search for related operating systems Common systems include Linux, Windows, RouterOS, IOS, JUNOS,\n etc. (\n other systems can be found in the domain name sidebar aggregation display of search results)\n- title=\"Cisco\" Search for data with \"Cisco\" in the title of the HTML content\n- industry=\"government\" Search for assets related to the specified industry type Common industry types include\n technology, energy, finance, manufacturing, etc. (other types can be supplemented with org data)\n\n- product=\"Cisco\" Search for assets with \"Cisco\" in the component information Support mainstream asset component\n search\n- protocol=\"TCP\" Search for assets with the transmission protocol as TCP Common transmission protocols include TCP,\n UDP, TCP6, SCTP\n- is_honeypot=\"True\" Filter for honeypot assets\n\n#### Time Node or Interval Related Search\n\n- after=\"2020-01-01\" && port=\"50050\" Search for assets with an update time after Jan 1, 2020 and a port 50050 Time\n filters need to be combined with other filters\n- before=\"2020-01-01\" && port=\"50050\" Search for assets with an update time before Jan 1, 2020 and a port 50050 Time\n filters need to be combined with other filters\n\n#### Dig\n\n- dig=\"baidu.com 220.181.38.148\" Search for assets with related dig content\n\n#### Iconhash\n\n- iconhash=\"f3418a443e7d841097c714d69ec4bcb8\" Analyze the target data by MD5 and search for assets with related content\n based on the icon Search for assets with the \"google\" icon\n- iconhash=\"1941681276\" Analyze the target data by MMH3 and search for assets with related content based on the icon\n Search for assets with the \"amazon\" icon\n\n#### Filehash\n\n- filehash=\"0b5ce08db7fb8fffe4e14d05588d49d9\" Search for assets with related content based on the parsed file data\n Search\n for assets parsed with \"Gitlab\"\n\n### Syntax Examples:\n\n- Search for all assets of China Merchants Group in Arabic\n org=\"مكتب التجار الصيني\" || ssl=\"مكتب التجار الصيني\"\n\n- Search for Starlink devices\n app=Starlink || device=Starlink\n\n- Search for network devices running http service on port 80\n port=80 && service=\"http\"\n\n- Search for network devices running ssl on port 443 in Nagoya\n city=nagoya && port=443 && service=ssl\n\n- Search for network devices running Windows operating system in the United States\n country=us && os=windows\n\n- Search for devices running Microsoft NTP application\n app=\"Microsoft NTP\"\n\n- Search for webcams in Tokyo\n city=tokyo && device=webcam\n\n- Search for industrial control devices with component 6ES7 315-2EH14-0AB0 running on port 102\n port=102 && module_id=6ES7 215-1BG40-0XB0\n\n- Search for assets indexed after 2020-01-01 with port 50050 open\n after=\"2020-01-01\" && port=50050\n\n- Search for assets in Delta, Canada\n country=Canada && city=Delta\n\n- Search for assets in Poland with Linux system and port 22\n os=linux && port=22 && country=PL\n\n- Search for FTP service with hostname example\n service=ftp && hostname=example\n\n- Search for IPv4 assets\n is_ipv4=true\n\n- Search for IPv6 assets\n is_ipv6=true\n\n- Search for IP assets containing \"FreeBSD\", including both IPv4 and IPv6\n FreeBSD && (is_ipv4=true || is_ipv6=true)\n\n- Search for website assets containing FreeBSD\n FreeBSD && is_domain=true\n\n- Search for assets with \"Knownsec\" in the body\n http.body=\"Knownsec\"\n\n- Search for specific Header hash\n http.header_hash=\"9763f6e29aa78e7ca2179ac82decbc25\"\n","inputSchema",{"_80":84,"_82":181,"_75":183},[182],"qbase64",{"_184":185,"_190":191,"_193":194,"_182":196,"_198":199,"_204":205,"_212":213},"page",{"_80":186,"_187":188,"_31":189},"integer","default",1,"View asset page number, default is 1","facets",{"_80":81,"_31":192},"Statistical items, separated by commas if there are multiple. Supports country, subdivisions, city, product, service, device, OS, and port","fields",{"_80":81,"_31":195},"The fields to return, separated by commas. Default: ip, port, domain, update_time",{"_80":81,"_31":197},"Base64 encoded query string for ZoomEye search","pagesize",{"_80":186,"_187":200,"_201":202,"_31":203},10,"maximum",1000,"Number of records per page, default is 10, maximum is 1000","sub_type",{"_206":207,"_80":81,"_31":211},"enum",[208,209,210],"v4","v6","web","Data type, supports v4, v6, and web. Default is v4","ignore_cache",{"_80":214,"_31":215},"boolean","Whether to ignore the cache. Supported by Business plan and above",{"_33":217,"_31":218,"_179":219},"zoomeye_vuldb_by_id","Search for detailed vulnerability information by vulnerability ID and return formatted results.\n\n Use this tool to retrieve comprehensive security vulnerability details from the vulnerability\n database using a vulnerability identifier (CVE, CNVD, CNNVD). Results include:",{"_80":84,"_82":220,"_75":222},[221],"cve_id",{"_221":223},{"_80":81,"_31":224},"A valid vulnerability identifier, eg: CVE-XXXX-XXXX,CNVD-XXXX-XXXX,CNNVD-XXXX-XXXX",{"_33":226,"_31":227,"_179":228},"zoomeye_vuldb_by_keyword","Search ZoomEye's vulnerability database for security vulnerabilities based on a specified keyword.\n\n This function queries the ZoomEye vulnerability database to retrieve information about known\n security vulnerabilities associated with specific products, vendors.\n Results include vulnerability details such as CVE IDs, severity ratings, affected versions,\n and vulnerability descriptions.",{"_80":84,"_82":229,"_75":231},[230],"keyword",{"_230":232,"_234":235},{"_80":81,"_31":233},"Search term to query the vulnerability database. This can be a product name,\n vendor name (e.g., \"nginx\", \"mysql\", \"tomcat\",\n \"WordPress\", \"hikvision\", \"huawei\").","page_size",{"_80":186,"_187":200,"_201":166,"_31":236},"Number of records per page, default is 10, maximum is 100.","kh74jb2ikb","updatedAt","2025-06-27T10:00:51.412412325Z","meta",[242,245,247,254,257,259,262,265,268,271,274,276,279,282,284,286,288,290,292],{"_243":244},"title","ZoomEye MCP Server | Glama",{"_246":32,"_33":31},"content",{"_248":249,"_250":251,"_252":253},"href","https://glama.ai/mcp/servers/@zoomeye-ai/mcp_zoomeye","rel","canonical","tagName","link",{"_246":34,"_255":256},"property","og:title",{"_246":32,"_255":258},"og:description",{"_246":260,"_255":261},"https://glama.ai/logo.png","og:logo",{"_246":263,"_255":264},"https://glama.ai/mcp/servers/@zoomeye-ai/mcp_zoomeye/og-image","og:image",{"_246":266,"_255":267},"630","og:image:height",{"_246":269,"_255":270},"1200","og:image:width",{"_246":272,"_255":273},"website","og:type",{"_246":249,"_255":275},"og:url",{"_246":277,"_255":278},"Glama – MCP Hosting Platform","og:site_name",{"_246":280,"_33":281},"summary_large_image","twitter:card",{"_246":277,"_33":283},"twitter:title",{"_246":32,"_33":285},"twitter:description",{"_246":263,"_33":287},"twitter:image",{"_246":266,"_33":289},"twitter:image:height",{"_246":269,"_33":291},"twitter:image:width",{"_293":294},"script:ld+json",{"_295":296,"_297":298},"@context","http://schema.org","@graph",[299],{"_295":300,"_301":302,"_303":304},"https://schema.org","@type","BreadcrumbList","itemListElement",[305,311,314,318],{"_301":306,"_307":308,"_33":309,"_310":188},"ListItem","item","https://glama.ai/","Glama","position",{"_301":306,"_307":312,"_33":313,"_310":121},"https://glama.ai/mcp","MCP",{"_301":306,"_307":315,"_33":316,"_310":317},"https://glama.ai/mcp/servers","Servers",3,{"_301":306,"_307":249,"_33":34,"_310":319},4,"visitorIsMaintainer",false,"routes/_public/mcp/servers/~namespace/~slug/_pages/reviews/_route",{"_68":-5,"_29":324,"_240":366,"_401":-5},{"_71":72,"_73":325,"_13":329,"_96":32,"_97":32,"_98":330,"_103":331,"_125":-5,"_16":126,"_127":128,"_129":333,"_33":34,"_155":117,"_156":-5,"_157":-5,"_158":159,"_160":-5,"_161":340,"_168":-5,"_137":113,"_169":341,"_174":342,"_118":237,"_238":239},{"_75":326,"_82":328,"_80":84},{"_77":327},{"_31":79,"_80":81},[77],[86,87,88,89,90,91,92,93,94,95],{"_35":100,"_101":102},{"_105":106,"_107":108,"_109":110,"_111":112,"_33":113,"_114":332,"_120":121,"_122":-5,"_123":124},{"_116":117,"_118":119},[334,336,338],{"_132":335,"_31":139,"_118":140},{"_134":135,"_33":136,"_137":138},{"_132":337,"_31":146,"_118":147},{"_134":143,"_33":144,"_137":145},{"_132":339,"_31":153,"_118":154},{"_134":150,"_33":151,"_137":152},{"_163":164,"_165":166,"_167":166},[171,172,173],[343,355,360],{"_33":177,"_31":178,"_179":344},{"_80":84,"_82":345,"_75":346},[182],{"_184":347,"_190":348,"_193":349,"_182":350,"_198":351,"_204":352,"_212":354},{"_80":186,"_187":188,"_31":189},{"_80":81,"_31":192},{"_80":81,"_31":195},{"_80":81,"_31":197},{"_80":186,"_187":200,"_201":202,"_31":203},{"_206":353,"_80":81,"_31":211},[208,209,210],{"_80":214,"_31":215},{"_33":217,"_31":218,"_179":356},{"_80":84,"_82":357,"_75":358},[221],{"_221":359},{"_80":81,"_31":224},{"_33":226,"_31":227,"_179":361},{"_80":84,"_82":362,"_75":363},[230],{"_230":364,"_234":365},{"_80":81,"_31":233},{"_80":186,"_187":200,"_201":166,"_31":236},[367,369,371,373,375,376,377,378,379,380,381,382,383,384,385,386,387,388,389],{"_243":368},"Reviews | ZoomEye MCP Server | Glama",{"_246":370,"_33":31},"Read community reviews and feedback for ZoomEye MCP Server. Discover user experiences, ratings, strengths, and potential limitations of this MCP implementation from actual users.",{"_248":372,"_250":251,"_252":253},"https://glama.ai/mcp/servers/@zoomeye-ai/mcp_zoomeye/reviews",{"_246":374,"_255":256},"Reviews | ZoomEye MCP Server",{"_246":370,"_255":258},{"_246":260,"_255":261},{"_246":263,"_255":264},{"_246":266,"_255":267},{"_246":269,"_255":270},{"_246":272,"_255":273},{"_246":372,"_255":275},{"_246":277,"_255":278},{"_246":280,"_33":281},{"_246":277,"_33":283},{"_246":370,"_33":285},{"_246":263,"_33":287},{"_246":266,"_33":289},{"_246":269,"_33":291},{"_293":390},{"_295":296,"_297":391},[392],{"_295":300,"_301":302,"_303":393},[394,395,396,397,398],{"_301":306,"_307":308,"_33":309,"_310":188},{"_301":306,"_307":312,"_33":313,"_310":121},{"_301":306,"_307":315,"_33":316,"_310":317},{"_301":306,"_307":249,"_33":34,"_310":319},{"_301":306,"_307":372,"_33":399,"_310":400},"Reviews",5,"review","actionData","errors"]

Rate & Review

MCP directory API