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
安装
- 克隆存储库：
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 startMCP集成
该服务器可以与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地址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