Zoomeye MCP Server

Zoomeye MCP Server

一个 MCP（Model Context Protocol）服务，可访问 ZoomEye v2 API，使 AI 助手能够查询全网主机和 Web 数据、查看账户配额，并（针对付费套餐）获取 IP 历史记录。

功能

• 主机搜索：按 IP、端口、服务等查询设备。
• Web 搜索：索引面向 Web 的应用和组件。
• 账户信息：查看你的 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 大模型集成。要将其添加到 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 地址
• max_items（可选）：数组中包含的最大项目数（默认值：5）
• fields（可选）：结果中要包含的字段列表（例如，['ip_str', 'ports', 'location.country_name']）

search_host

搜索主机端的设备和服务。

参数：

• query（必需）：Shodan 搜索查询（例如，'apache country:US'）
• page（可选）：结果分页的页码（默认值：1）
• facets（可选）：搜索结果中要包含的分面列表（例如，['country', 'org']）
• max_items（可选）：数组中包含的最大项目数（默认值：5）
• fields（可选）：结果中要包含的字段列表（例如，['ip_str', 'ports', 'location.country_name']）
• summarize（可选）：是否返回结果摘要而非完整数据（默认值：false）

search_web

在 ZoomEye 数据库中搜索 Web 资源

参数：

• query（必需）：Shodan 搜索查询（例如，'apache country:US'）
• page（可选）：结果分页的页码（默认值：1）
• facets（可选）：搜索结果中要包含的分面列表（例如，['country', 'org']）

get_history_ip

（付费）获取某个 IP 的历史扫描数据。

参数：

• ip（必需）：要获取历史扫描数据的 IP 地址（例如，ip="8.8.8.8"）

summarize

生成热门国家、端口和组织的摘要。

参数：

• device_type（必需）：要搜索的 IoT 设备类型（例如，'webcam'、'router'、'smart tv'）
• country（可选）：用于限制搜索范围的国家代码（例如，'US'、'DE'）
• max_items（可选）：结果中包含的最大项目数（默认值：5）

可用资源

• zoomeye://host/{ip}：指定 IP 地址的信息

API 限制

部分 Zoomeye API 端点需要付费会员资格。以下功能仅可通过付费 Zoomeye API 密钥使用：

• 更多付费功能
• 搜索功能
• 网络扫描
• SSL 证书查询
• IoT 设备搜索

按照上述结构配置后，你的 zoomeye‑mcp‑server 即可无缝接入任何兼容 MCP 的客户端，为 AI 助手提供 ZoomEye 强大的网络空间搜索能力的实时访问权限。

许可证

ZGCLAB

开发者

NASP