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

1. get_credits：检查您ZeroBounce帐户中的剩余积分

   get_credits() -> dict

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

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

1. check_file_status：检查批量验证文件的状态

   check_file_status(file_id: str) -> dict

1. get_file：获取批量验证的结果

   get_file(file_id: str) -> dict

1. 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：用于异步操作