管理ZoomEye服务器

@zoomeye-ai/mcp_zoomeye
0 Stars 352 次浏览 zoomeye-ai 更新于 2026-08-23

用于查询ZoomEye API的MCP服务器

开发者工具搜索工具
该服务暂未提供标准配置，请参考 README 手动接入

服务介绍

ZoomEye MCP 服务器

这是一个基于查询条件提供网络资产信息的模型上下文协议（MCP）服务器。该服务器允许大型语言模型（LLMs）通过使用dorks和其他搜索参数查询ZoomEye来获取网络资产信息。

此MCP服务器与Claude Desktop、Cursor、Windsurf、Cline、Continue和Zed等AI助手及开发环境集成，使它们能够通过自然语言交互搜索并分析互联网连接的设备、服务和漏洞。

功能

  • 使用dorks查询ZoomEye以获得网络资产信息
  • 缓存机制以提高性能并减少API调用
  • API请求失败时自动重试机制
  • 全面的错误处理和日志记录

可用工具

  • zoomeye_search - 根据查询条件获取网络资产信息。
    • 必需参数：
      • qbase64 (字符串): 对ZoomEye搜索进行Base64编码的查询字符串
    • 可选参数：
      • page (整数): 查看资产页面编号，默认为1
      • pagesize (整数): 每页记录数，默认为10，最大为1000
      • fields (字符串): 要返回的字段，多个字段之间用逗号分隔
      • sub_type (字符串): 数据类型，支持v4, v6和web。默认值是v4
      • facets (字符串): 统计项目，如果有多个，则用逗号分隔
      • ignore_cache (布尔值): 是否忽略缓存

使用指南

基本使用

一旦服务器运行起来，您就可以通过您的AI助手或开发环境与其交互了。以下是使用方法：

  1. 启动服务器 使用上述安装方法之一
  2. 配置您的AI助手（如Claude Desktop、Cursor、Windsurf、Cline、Continue、Zed等），使其使用该服务器
  3. 使用自然语言查询网络信息

searchexample

搜索语法指南

  • 搜索范围涵盖设备(IPv4, IPv6)和网站(域名)。
  • 输入搜索字符串时，系统将以“全局”模式匹配关键字，包括来自各种协议的内容，例如HTTP、SSH、FTP等（例如HTTP/HTTPS协议头、正文、SSL、标题及其他协议横幅）。
  • 搜索字符串不区分大小写，并将被分段匹配（搜索结果页面提供了“分段”测试功能）。当使用==进行搜索时，它强制执行严格语法下的精确大小写匹配。
  • 请对搜索字符串使用引号（例如 "Cisco System" 或 'Cisco System'）。如果搜索字符串包含引号，请使用转义字符，例如 "a"b"。如果搜索字符串包含括号，请使用转义字符，例如 portinfo()。

您可以查看prompts.py中更详细的搜索语法规则。

有关ZoomEye搜索API的更多信息，请参阅ZoomEye API v2文档。

开始前准备

先决条件

  1. ZoomEye API Key

    • 在 ZoomEye 注册一个账户
    • 从您的账户设置中获取您的 API 密钥
    • 此 API 密钥将用于验证您对 ZoomEye API 的请求

  2. Python 环境

    • 需要 Python 3.10 或更高版本
    • 或者，您可以使用 Docker 运行服务器而无需安装 Python

安装

使用 PIP

或者，您可以通过 pip 安装 mcp-server-zoomeye：

pip install mcp-server-zoomeye

安装后，您可以使用以下命令将其作为脚本运行：

python -m mcp_server_zoomeye

使用 Docker

您也可以使用 Docker 运行 ZoomEye MCP 服务器：

从 Docker Hub 拉取

# Pull the latest image
docker pull zoomeyeteam/mcp-server-zoomeye:latest

# Run the container with your API key
docker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:latest

注意：我们提供支持 linux/amd64 和 linux/arm64 平台的多架构 Docker 镜像，并且可以在 Intel/AMD 和 ARM（例如 Apple Silicon）处理器上运行。

从源代码构建

或者，您可以从源代码构建 Docker 镜像：

# Clone the repository
git clone https://github.com/zoomeye-ai/mcp_zoomeye.git
cd mcp_zoomeye

# Build the Docker image
docker build -t zoomeyeteam/mcp-server-zoomeye:local .

# Run the container
docker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:local

使用 uv

uv 是一个用 Rust 编写的快速 Python 包安装器和解析器。它是 pip 的现代替代品，提供了显著的性能改进。

安装 uv

# Install uv using curl (macOS/Linux)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or using PowerShell (Windows)
irm https://astral.sh/uv/install.ps1 | iex

# Or using Homebrew (macOS)
brew install uv

使用 uvx 运行 mcp-server-zoomeye

使用 uvx 时不需要特定的安装，它允许您直接运行 Python 包：

使用 uv 安装

或者，您可以使用 uv 安装包：

# Install in the current environment
uv pip install mcp-server-zoomeye

# Or create and install in a new virtual environment
uv venv
uv pip install mcp-server-zoomeye

配置

环境变量

ZoomEye MCP 服务器需要以下环境变量：

  • ZOOMEYE_API_KEY: 用于身份验证的 ZoomEye API 密钥

您可以采用以下几种方式设置此环境变量：

  1. 在 shell 会话中导出：

    export ZOOMEYE_API_KEY="your_api_key_here"

  2. 在运行容器时直接传递（对于 Docker）：

    docker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:latest

配置 Claude.app

在 Claude 设置中添加以下内容：

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

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

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

配置 Zed

在 Zed 的 settings.json 中添加以下内容：

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

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

示例交互

示例 1：检索全球 Apache Tomcat 资产

{
  "name": "zoomeye_search",
  "arguments": {
    "qbase64": "app=\"Apache Tomcat\""
  }
}

响应：

{
  "code": 60000,
  "message": "success",
  "total": 163139107,
  "query": "title=\"cisco vpn\"",
  "data": [
    {
      "url": "https://1.1.1.1:443",
      "ssl.jarm": "29d29d15d29d29d00029d29d29d29dea0f89a2e5fb09e4d8e099befed92cfa",
      "ssl.ja3s": "45094d08156d110d8ee97b204143db14",
      "iconhash_md5": "f3418a443e7d841097c714d69ec4bcb8",
      "robots_md5": "0b5ce08db7fb8fffe4e14d05588d49d9",
      "security_md5": "0b5ce08db7fb8fffe4e14d05588d49d9",
      "ip": "1.1.1.1",
      "domain": "www.google.com",
      "hostname": "SPACEX",
      "os": "windows",
      "port": 443,
      "service": "https",
      "title": ["GoogleGoogle appsGoogle Search"],
      "version": "1.1.0",
      "device": "webcam",
      "rdns": "c01031-001.cust.wallcloud.ch",
      "product": "OpenSSD",
      "header": "HTTP/1.1 302 Found Location: https://www.google.com/?gws_rd=ssl Cache-Control: private...",
      "header_hash": "27f9973fe57298c3b63919259877a84d",
      "body": "HTTP/1.1 302 Found Location: https://www.google.com/?gws_rd=ssl Cache-Control: private...",
      "body_hash": "84a18166fde3ee7e7c974b8d1e7e21b4",
      "banner": "SSH-2.0-OpenSSH_7.6p1 Ubuntu-4ubuntu0.3",
      "update_time": "2024-07-03T14:34:10",
      "header.server.name": "nginx",
      "header.server.version": "1.8.1",
      "continent.name": "Europe",
      "country.name": "Germany",
      "province.name": "Hesse",
      "city.name": "Frankfurt",
      "lon": "118.753262",
      "lat": "32.064838",
      "isp.name": "aviel.ru",
      "organization.name": "SERVISFIRST BANK",
      "zipcode": "210003",
      "idc": 0,
      "honeypot": 0,
      "asn": 4837,
      "protocol": "tcp",
      "ssl": "SSL Certificate Version: TLS 1.2 CipherSuit: TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256...",
      "primary_industry": "Finance",
      "sub_industry": "bank",
      "rank": 60
    }
  ]
}

调试和故障排除

使用 MCP Inspector

模型上下文协议检查器是一种工具，通过模拟客户端交互来帮助调试 MCP 服务器。您可以使用它来测试您的 ZoomEye MCP 服务器：

# For uvx installation
npx @modelcontextprotocol/inspector uvx mcp-server-zoomeye

# If developing locally
cd path/to/servers/src/mcp_server_zoomeye
npx @modelcontextprotocol/inspector uv run mcp-server-zoomeye

常见问题

请根据实际需求替换上述 #0 到 #13 的内容。

  1. 认证错误

    • 确保您的ZoomEye API密钥正确并且已正确设置为环境变量
    • 检查您的API密钥是否未过期或被撤销

  2. 连接问题

    • 验证您的互联网连接
    • 检查ZoomEye API是否正在经历停机时间

  3. 无结果

    • 您的查询可能过于具体或包含语法错误
    • 尝试简化您的查询或使用不同的搜索词

  4. 速率限制

    • ZoomEye API根据您的账户类型有速率限制
    • 请间隔您的请求或升级您的账户以获得更高的限制

高级用法

缓存

ZoomEye MCP服务器实现了缓存功能，以提高性能并减少API调用：

  • 响应基于查询参数进行缓存
  • 缓存持续时间可配置（默认：1小时）
  • 您可以通过在查询中将ignore_cache设置为true来绕过缓存

自定义字段

您可以通过使用fields参数，在查询结果中请求特定字段：

{
  "name": "zoomeye_search",
  "arguments": {
    "qbase64": "app=\"Apache\"",
    "fields": "ip,port,domain,service,os,country,city"
  }
}

分页

对于返回大量结果的查询，您可以分页浏览它们：

{
  "name": "zoomeye_search",
  "arguments": {
    "qbase64": "app=\"Apache\"",
    "page": 2,
    "pagesize": 20
  }
}

贡献

我们鼓励向mcp-server-zoomeye贡献代码，以帮助扩展和改进其功能。无论是添加新的相关工具、增强现有功能还是改进文档，您的输入都是宝贵的。

有关其他MCP服务器和其他实现模式的例子，请参见：
https://github.com/modelcontextprotocol/servers

欢迎提交拉取请求！随时提出新想法、修复bug或进行增强，使mcp-server-zoomeye更加健壮和实用。

许可证

mcp-server-zoomeye采用MIT许可证授权。这意味着您可以自由地使用、修改和分发该软件，但须遵守MIT许可证的条款和条件。更多信息，请查看项目仓库中的LICENSE文件。

查看源码 项目主页

相关 MCP 服务

LeetCode(力扣)
jinzcdev/leetcode-mcp-server
MCP 服务器实现 LeetCode API 集成，支持自动化获取编程题库、用户数据和竞赛信息。
可视化图表-MCP-Server
antvis/mcp-server-chart
这是一个基于AntV的模型上下文协议服务器，用于生成图表。它支持超过20种类型的图表，并且可以与多种桌面应用程序和平台一起使用。
微软Playwright
@microsoft/playwright-mcp
一种模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页交互，而无需使用视觉模型或截图。
MCP上下文模型文档
@upstash/context7-mcp
一种模型上下文协议服务器，它从库中直接获取最新、特定版本的文档和代码示例并将其引入LLM提示中，帮助开发人员在无需过时或虚构信息的情况下获得准确的答案。