Zoomeye MCP Server

🚀 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