JinDaGe - zoomeye-mcp-server MCP Details

article

README

🚀 ZoomEye MCP 服务器

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

✨ 主要特性

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

📦 安装指南

先决条件

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

安装步骤

克隆仓库：

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

安装依赖项：

npm install

构建服务器：

npm run build

设置您的 ZoomEye API 密钥：

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

启动服务器：

npm start

📚 详细文档

MCP 集成

此服务器可与支持 MCP 的 AI LLM 集成。若要将其添加到 Cline、Curser 或 Claude 中，可按以下步骤操作：

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

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

重新加载新的 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

zoomeye-mcp-server