ZoomEye MCP Server
2025.03.19
23
Python网络资产查询网络安全搜索工具
ZoomEye MCP Server 是一个基于模型上下文协议（MCP）的服务，提供基于查询条件的网络资产信息。该服务允许大型语言模型（LLMs）通过查询ZoomEye获取网络资产信息，支持dorks和其他搜索参数。该MCP服务器集成了多种AI助手和开发环境，如Claude Desktop、Cursor、Windsurf、Cline、Continue和Zed，使它们能够通过自然语言交互搜索和分析互联网连接的设备、服务和漏洞。
View on GitHub
Overview
基本能力
产品定位
ZoomEye MCP Server 是一个网络资产信息查询服务，专为AI助手和开发环境设计，提供高效、灵活的网络资产搜索能力。
核心功能
- 使用dorks查询ZoomEye获取网络资产信息
- 缓存机制以提高性能并减少API调用
- 自动重试机制处理失败的API请求
- 全面的错误处理和日志记录
适用场景
- AI助手集成网络资产搜索功能
- 开发环境中的网络资产分析
- 网络安全研究和漏洞发现
工具列表
zoomeye_search：基于查询条件获取网络资产信息- 必需参数：
qbase64（Base64编码的查询字符串） - 可选参数：
page（页码）、pagesize（每页记录数）、fields（返回字段）、sub_type（数据类型）、facets（统计项）、ignore_cache（是否忽略缓存）
常见问题解答
- 认证错误：确保ZoomEye API密钥正确且已设置为环境变量
- 连接问题：检查互联网连接和ZoomEye API状态
- 无结果：查询可能过于具体或包含语法错误
- 速率限制：ZoomEye API根据账户类型有速率限制
使用教程
使用依赖
- ZoomEye API密钥
- 在ZoomEye注册账户
- 从账户设置获取API密钥
- Python环境
- Python 3.10或更高版本
- 或使用Docker运行服务器
安装教程
使用PIP安装
pip install mcp-server-zoomeye
运行命令：
python -m mcp_server_zoomeye
使用Docker
docker pull zoomeyeteam/mcp-server-zoomeye:latest
docker run -i --rm -e ZOOMEYE_API_KEY=your_api_key_here zoomeyeteam/mcp-server-zoomeye:latest
使用uv
安装uv：
curl -LsSf https://astral.sh/uv/install.sh | sh
安装包：
uv pip install mcp-server-zoomeye
调试方式
使用MCP Inspector调试：
npx @modelcontextprotocol/inspector uvx mcp-server-zoomeye