Zoomeye MCP Server

Zoomeye MCP Server

site icon
2025.04.22 0
TypeScript网络空间搜索网络安全分析搜索工具开发效率
Zoomeye MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,提供对 ZoomEye v2 API 的访问,使 AI 助手能够查询互联网范围内的主机和 Web 数据,查看账户配额,以及(对于付费计划)获取 IP 历史记录。
View on GitHub

Overview

基本能力

产品定位

Zoomeye MCP Server 是一个提供网络空间搜索能力的服务,主要用于查询和分析互联网上的主机和 Web 应用数据。

核心功能

  • 主机搜索:通过 IP、端口、服务等查询设备。
  • Web 搜索:索引面向 Web 的应用和组件。
  • 账户信息:查看 ZoomEye 计划和剩余查询配额。
  • 结果采样:限制响应大小并选择所需字段。
  • 摘要生成:自动生成国家、端口和组织的前几名摘要。
  • IP 历史记录(付费):获取给定 IP 的历史扫描数据。

适用场景

  • 网络安全分析
  • 网络设备监控
  • Web 应用组件索引
  • 历史数据查询(付费用户)

工具列表

  • get_account_info:获取特定 IP 地址的详细信息。
  • search_host:主机端搜索设备和服务的工具。
  • search_web:搜索 ZoomEye 数据库中的 Web 资源。
  • get_history_ip(付费):获取 IP 的历史扫描数据。
  • summarize:生成国家、端口和组织的前几名摘要。

常见问题解答

  • API 限制:某些 ZoomEye API 端点需要付费会员才能使用。
  • 付费功能:包括搜索功能、网络扫描、SSL 证书查找和 IoT 设备搜索等。

使用教程

使用依赖

  • Node.js ≥ 16
  • ZoomEye API Key(可在 https://www.zoomeye.org/profile 获取)
  • 互联网访问 https://api.zoomeye.org

安装教程

  1. 克隆仓库: bash git clone https://github.com/help116114/zoomeye-mcp-server.git cd zoomeye-mcp-server
  2. 安装依赖: bash npm install
  3. 构建服务器: bash npm run build
  4. 设置 ZoomEye API 密钥: bash export Zoomeye_API_KEY="your-api-key-here"
  5. 启动服务器: bash npm start

调试方式

  1. 将服务器添加到 MCP 设置中: json { "mcpServers": { "zoomeye": { "command": "node", "args": ["./build/index.js"], "env": { "ZOOMEYE_API_KEY": "your-api-key-here" } } } }
  2. 重新加载新的 MCP 服务器。

许可证

该项目遵循 None 开源许可条款。