ZoomEye MCP Server - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

ZoomEye MCP Server 是一个网络资产信息查询服务，专为AI助手和开发环境设计，提供高效、灵活的网络资产搜索能力。

核心功能

• 使用dorks查询ZoomEye获取网络资产信息
• 缓存机制以提高性能并减少API调用
• 自动重试机制处理失败的API请求
• 全面的错误处理和日志记录

适用场景

• AI助手集成网络资产搜索功能
• 开发环境中的网络资产分析
• 网络安全研究和漏洞发现

工具列表

• zoomeye_search：基于查询条件获取网络资产信息
• 必需参数：qbase64（Base64编码的查询字符串）
• 可选参数：page（页码）、pagesize（每页记录数）、fields（返回字段）、sub_type（数据类型）、facets（统计项）、ignore_cache（是否忽略缓存）

常见问题解答

1. 认证错误：确保ZoomEye API密钥正确且已设置为环境变量
2. 连接问题：检查互联网连接和ZoomEye API状态
3. 无结果：查询可能过于具体或包含语法错误
4. 速率限制：ZoomEye API根据账户类型有速率限制

使用教程

使用依赖

1. ZoomEye API密钥
2. 在ZoomEye注册账户
3. 从账户设置获取API密钥
4. Python环境
5. Python 3.10或更高版本
6. 或使用Docker运行服务器

安装教程

使用PIP安装

bash
pip install mcp-server-zoomeye
运行命令：
bash
python -m mcp_server_zoomeye

使用Docker

bash
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：
bash
curl -LsSf https://astral.sh/uv/install.sh | sh
安装包：
bash
uv pip install mcp-server-zoomeye

调试方式

使用MCP Inspector调试：
bash
npx @modelcontextprotocol/inspector uvx mcp-server-zoomeye