AI导哈

网络空间搜索服务

Zoomeye MCP Server是一个提供ZoomEye v2 API访问的MCP服务器，使AI助手能够查询全球范围内的主机和网络数据，查看账户配额，并为付费计划获取IP历史记录。

  • by help116114
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 help116114/zoomeye-mcp-server

使用说明

Zoomeye MCP服务器

MCP（模型上下文协议）服务器，提供对ZoomEye v2 API的访问，使人工智能助手能够查询互联网主机和网络数据，查看帐户配额，并（对于付费计划）获取IP历史记录。

特性

  • 主机搜索：按IP、端口、服务等查询设备。
  • 网页搜索：索引面向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 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地址
  • max_items （可选）：数组中包含的最大项目数（默认值：5）
  • fields （可选）：要包含在结果中的字段列表（例如，['ip_str'、'ports'、'location.country_name'）

search_host

主机端搜索设备和服务。

参数：

  • query （必填）：Shodan搜索查询（例如，“apache国家：美国”）
  • page （可选）：结果分页的页码（默认值：1）
  • facets （可选）：搜索结果中要包含的方面列表（例如，[“国家”、“组织”]）
  • max_items （可选）：数组中包含的最大项目数（默认值：5）
  • fields （可选）：要包含在结果中的字段列表（例如，['ip_str'、'ports'、'location.country_name'）
  • summarize （可选）：是否返回结果摘要而不是完整数据（默认值：false）

search_web

在ZoomEye数据库中搜索网络资源

参数：

  • query （必填）：Shodan搜索查询（例如，“apache国家：美国”）
  • page （可选）：结果分页的页码（默认值：1）
  • facets （可选）：搜索结果中要包含的方面列表（例如，[“国家”、“组织”]）

get_history_ip

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

参数：

  • ip （必填）：用于获取历史扫描数据的IP地址（例如，IP=“8.8.8.8”）

总结

生成顶级国家、港口和组织摘要。

参数：

  • device_type （必填）：要搜索的物联网设备类型（例如，“网络摄像头”、“路由器”、“智能电视”）
  • country （可选）：用于限制搜索的可选国家代码（例如，“US”、“DE”）
  • max_items （可选）：结果中包含的最大项目数（默认值：5）

可用资源

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

API限制

某些Zoomeye API端点需要付费会员资格。以下功能仅适用于付费的Zoomeye API密钥：

  • 更多付费
  • 搜索功能
  • 网络扫描
  • SSL证书查找
  • 物联网设备搜索

通过遵循上述结构，您的 zoomeye-mcp服务器 将无缝插入任何兼容MCP的客户端，为AI助手提供对ZoomEye强大网络空间搜索功能的实时访问。

许可证

ZGCLAB

由开发

国家航空航天飞机

相关 MCP