ZeroBounce MCP服务器
这是一个用于与ZeroBounce电子邮件验证服务交互的模型上下文协议(MCP)服务器。它使用官方 ZeroBounce Python API v2 图书馆。
特性
- 验证个人电子邮件地址
- 检查您剩余的API信用
- 上传文件进行批量验证
- 检查文件状态,检索和删除批量验证文件
- 搜索域使用的电子邮件模式
设置
系统要求
- Python 3.10+
- 来自ZeroBounce的API密钥
安装
- 克隆此存储库:```bash
git clone https://github.com/avivshafir/zerobounce-mcp-server
cd zerobounce-mcp-server
2. 安装所需的依赖项:```bash
pip install -r requirements.txt
- 设置环境变量:
选项1:使用.env文件(推荐)
使用ZeroBounce API键创建.env文件:```
ZEROBOUNCE_API_KEY=your_zerobounce_api_key
选项2:直接设置环境变量```bash
export ZEROBOUNCE_API_KEY="your_zerobounce_api_key"
您可以从ZeroBounce帐户仪表板获取API密钥。
将以下配置添加到 mcp.json 文件,将目录路径替换为安装此服务器的实际路径:```json
{
"mcpServers": {
"zerobounce": {
"command": "python",
"args": ["/path/to/your/zerobounce-mcp-server/main.py"]
}
}
}
4. 重新启动Cursor以应用更改
现在,您可以直接在Cursor的AI助手中使用ZeroBounce MCP服务器。
## 可用工具
服务器提供以下工具:
1. `validate_email`:验证单个电子邮件地址```
validate_email(email: str, ip_address: str = "") -> dict
get_credits:检查您ZeroBounce帐户中的剩余积分```
get_credits() -> dict
1. `upload_file`:上传文件进行批量验证```
upload_file(file_path: str, email_column: int, ...) -> dict
check_file_status:检查批量验证文件的状态```
check_file_status(file_id: str) -> dict
1. `get_file`:获取批量验证的结果```
get_file(file_id: str) -> dict
delete_file:删除批量验证文件```
delete_file(file_id: str) -> dict
1. `domain_search`:搜索域使用的电子邮件模式```
domain_search(domain: str) -> dict
依赖项
- zeroboundce-python-api-v2:zerobounce api官方库
- python dotenv:用于从.env文件加载环境变量
- mcp:模型上下文协议库
- asyncio:用于异步操作
