ZeroBounce MCP Server

ZeroBounce MCP 服务

这是一个用于与 ZeroBounce 邮箱验证服务交互的模型上下文协议（MCP）服务。它使用官方的 ZeroBounce Python API v2 库。

功能

• 验证单个邮箱地址
• 查看剩余 API 额度
• 上传文件以进行批量验证
• 查看文件状态、获取并删除批量验证文件
• 搜索域名使用的邮箱模式

设置

系统要求

• Python 3.10+
• ZeroBounce API 密钥

安装

1. 克隆此仓库：

git clone https://github.com/avivshafir/zerobounce-mcp-server
cd zerobounce-mcp-server

2. 安装所需依赖：

pip install -r requirements.txt

3. 设置环境变量：

   选项 1：使用 .env 文件（推荐）

   创建一个包含 ZeroBounce API 密钥的 .env 文件：

   ZEROBOUNCE_API_KEY=your_zerobounce_api_key
   

   选项 2：直接设置环境变量

   export ZEROBOUNCE_API_KEY="your_zerobounce_api_key"
   

你可以在 ZeroBounce 账户控制面板中获取 API 密钥。

将以下配置添加到 mcp.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
   

2. get_credits：查看 ZeroBounce 账户的剩余额度

   get_credits() -> dict
   

3. upload_file：上传文件以进行批量验证

   upload_file(file_path: str, email_column: int, ...) -> dict
   

4. check_file_status：查看批量验证文件的状态

   check_file_status(file_id: str) -> dict
   

5. get_file：获取批量验证结果

   get_file(file_id: str) -> dict
   

6. delete_file：删除批量验证文件

   delete_file(file_id: str) -> dict
   

7. domain_search：搜索域名使用的邮箱模式

   domain_search(domain: str) -> dict
   

依赖项

• zerobounce-python-api-v2：ZeroBounce 官方 API 库
• python-dotenv：用于从 .env 文件加载环境变量
• mcp：模型上下文协议库
• asyncio：用于异步操作