AI导哈

邮箱验证服务

ZeroBounce MCP Server是一个基于ZeroBounce API的邮箱验证服务，支持单邮箱验证、批量文件验证、API信用查询及域名邮箱模式搜索。

  • by avivshafir
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 avivshafir/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
  1. 安装所需的依赖项：
pip install -r requirements.txt

  1. 设置环境变量：

    选项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"]
    }
  }
}
  1. 重新启动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

依赖项

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

相关 MCP