MCP zoomeye

🚀 ZoomEye MCP服务器

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

🔔 公告

🎉 我们很高兴地宣布官方开源版本 ZoomEye MCP服务器 --强大的模型上下文协议（MCP）服务器，为人工智能助手和开发环境带来实时网络资产情报。

🚀 免费试用：7天免费使用ZoomEye MCP！ 体验由人工智能驱动的网络空间资产搜索引擎ZoomEye MCP，免费7天！

🔍 搜索全球互联网资产，跟踪实时变化，并解锁人工智能驱动的见解——所有这些都在一个地方。

👉 如何索赔：

1. 在推特上关注我们： @zoomey_team
2. DM us“MCP”和您的MCP设置屏幕截图
3. 立即访问您的7天会员资格

🎁 限时免费试用——立即探索人工智能资产搜索的力量！

💡 提供被正式采纳的有见地的反馈，你就会解锁 更多奖励!

🔧 与领先的MCP环境完全兼容：

• 克劳德桌面
• 光标
• 帆板运动
• 克莱恩
• 继续
• 泽德
• 樱桃工作室
• 聊天框

🔗 探索ZoomEye MCP服务器：

• github： zoomeye ai/mcpzoomeye
• MCP.so： mcp.so/server/mcp_zoomeye
• 光标目录： cursor.directory/cp/zoomeye
• 脉冲MCP： pulsemcp.com/servers/zoomeye
• Glama MCP： glama.ai/mcp/服务器

我们欢迎大家使用、探索和贡献！

🔑 如何获取ZoomEye API密钥？

要使用此MCP服务器，您需要ZoomEye API密钥。

1. 首选https://www.zoomeye.ai

1. 注册或登录

1. 点击您的头像→ 个人资料

1. 复制您的 API-KEY公司

1. 设置环境变量：

export ZOOMEYE_API_KEY="your_api_key_here"

zoomeye1

zoomeye2

特性

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

可用工具

• zoomeye_search -根据查询条件获取网络资产信息。

- 所需参数： - qbase64 （string）：用于ZoomEye搜索的Base64编码查询字符串 - 可选参数： - page （整数）：查看资产页码，默认为1 - pagesize （整数）：每页记录数，默认为10，最大为1000 - fields （string）：要返回的字段，用逗号分隔 - sub_type （string）：数据类型，支持v4、v6和web。默认值为v4 - facets （string）：统计项目，如果有多个，用逗号分隔 - ignore_cache （boolean）：是否忽略缓存

使用指南

基本用法

服务器运行后，您可以通过AI助手或开发环境与它进行交互。以下是如何使用它：

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

searchexample

搜索语法指南

• 搜索范围涵盖设备（IPv4、IPv6）和网站（域）。
• 当输入搜索字符串时，系统将以“全局”模式匹配关键字，包括来自各种来源的内容

HTTP、SSH、FTP等协议。（例如，HTTP/HTTPS协议头、正文、SSL、标题和其他协议 横幅）。

• 搜索字符串不区分大小写，将被分段进行匹配（搜索结果页面提供“

当使用==进行搜索时，它会强制执行严格语法的精确区分大小写的匹配。

• 请在搜索字符串中使用引号（例如，“Cisco System”或“思科系统”）。如果搜索字符串包含引号，

使用转义符，例如“a”b。如果搜索字符串包含括号，请使用转义符。， portinfo（）。

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

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

入门指南

先决条件

1. ZoomEye API密钥

- 在以下网址注册帐户 ZoomEye - 从您的帐户设置中获取API密钥 - API密钥将用于验证您对ZoomEye API的请求

1. Python环境

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

安装

使用PIP

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

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

备注：我们提供支持多种架构的Docker镜像 linux/amd64 和 linux/arm64 平台，可以在Intel/AMD和ARM（如苹果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 是一个用Rust编写的快速Python包安装程序和解析器。它是pip的现代替代品，提供了显著的性能改进。

紫外线安装

# 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服务器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"

1. 运行容器时直接传递 （适用于Docker）：

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

配置Claude.app

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

Using uvx

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

Using docker

"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"
    }
  }
}

Installed via pip

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

配置Zed

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

Using uvx

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

Installed via pip

"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": "app=\"Apache Tomcat\"",
  "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检查器

模型上下文协议检查器是一个通过模拟客户端交互来帮助调试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

常见问题

1. 身份验证错误

- 确保您的ZoomEye API密钥正确，并正确设置为环境变量 - 请检查您的API密钥是否已过期或已被吊销

1. 连接问题

- 验证您的互联网连接 - 检查ZoomEye API是否处于停机状态

1. 无结果

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

1. 速率限制

- 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服务器zoomeye做出贡献，以帮助扩展和改进其功能。无论是添加新的相关工具、增强现有功能还是改进文档，您的意见都是有价值的。

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

欢迎拉取请求！请随时贡献新想法、错误修复或增强功能，使mcp服务器zoomeye更加健壮和实用。

许可证

mcp服务器zoomeye根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多信息，请参阅项目存储库中的LICENSE文件。