🚀 ZoomEye MCP 服务器

ZoomEye MCP 服务器是一个提供 ZoomEye v2 API 访问的 MCP（模型上下文协议）服务器。它能让 AI 助手查询互联网范围内的主机和网络数据，查看账户配额，付费计划用户还能获取 IP 历史记录。

🚀 快速开始

ZoomEye MCP 服务器可助力 AI 助手访问 ZoomEye v2 API，实现对互联网主机和网络数据的查询等功能。以下是使用前的准备工作和操作步骤。

✨ 主要特性

• 主机搜索：可通过 IP、端口、服务等条件查询设备。
• 网络搜索：能对面向网络的应用程序和组件进行索引。
• 账户信息：可查看您的 ZoomEye 计划和剩余查询配额。
• 结果采样：能限制响应大小，并选择所需字段。
• 摘要生成：可自动生成顶级国家、端口和组织的摘要。
• （付费）IP 历史记录：付费用户可检索特定 IP 的历史扫描数据。

📦 安装指南

先决条件

• Node.js ≥ 16
• ZoomEye API 密钥（可在 https://www.zoomeye.org/profile 获取）
• 可访问互联网到 https://api.zoomeye.org

安装步骤

1. 克隆仓库：

git clone https://github.com/help116114/zoomeye-mcp-server.git
cd zoomeye-mcp-server

2. 安装依赖项：

npm install

3. 构建服务器：

npm run build

4. 设置您的 ZoomEye API 密钥：

export Zoomeye_API_KEY="your-api-key-here"

5. 启动服务器：

npm start

💻 使用示例

MCP 集成

此服务器可与支持 MCP 的 AI LLM 集成。要将其添加到 Cline、Curser 或 Claude 中：

1. 将服务器添加到您的 MCP 设置中：

{
  "mcpServers": {
    "zoomeye": {
      "command": "node",
      "args": ["./build/index.js"],
      "env": {
        "ZOOMEYE_API_KEY": "your-api-key-here"
      }
    }
  }
}

2. 重新加载新的 MCP 服务器。

可用工具

get_account_info

获取特定 IP 地址的详细信息。 参数:

• IP 地址：要查询的 IP 地址（必需）。 示例响应：

{
  "status": "success",
  "data": {
    "ip": "192.168.1.1",
    "hostname": "example.com",
    "geolocation": {
      "country": "中国",
      "city": "北京"
    },
    "ports": ["80", "443"]
  }
}

search_host

通过 IP 或域名搜索主机信息。 参数:

• query：要搜索的 IP 地址或域名（必需）。
• max_items：返回的最大项目数（可选，默认为 10）。

get_ip_history

获取特定 IP 的历史扫描数据。 参数:

• ip：特定 IP 地址（必需）。

📚 详细文档

资源

zoomeye://host/{ip}：表示要查询的主机资源。

API 限制

• 免费计划：每小时限制 100 次请求。
• 付费计划：提供更高配额和更多高级功能。

📄 许可证

ZGCLAB

开发者

NASP