🚀 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