Zerobounce MCP

ZeroBounce MCP服务器

一个全面的模型上下文协议（MCP）服务器，通过ZeroBounce的API提供全功能的电子邮件验证、验证和智能功能。该服务器使AI编码助手和MCP兼容客户端能够验证电子邮件地址、查找电子邮件、对电子邮件质量进行评分、搜索域名等等。

特性

核心能力

• 邮件验证：使用详细结果验证单个或多个电子邮件地址
• 批处理：通过CSV上传高效处理大量电子邮件
• AI评分：通过批量CSV文件上传使用AI评估电子邮件质量和可送达性
• 邮件搜索者：根据姓名和公司/域名查找电子邮件地址
• 域搜索：搜索域中的所有电子邮件地址
• 活动数据：检查电子邮件地址最近是否处于活动状态
• 信用管理：监控您ZeroBounce帐户中的剩余积分
• 使用情况分析：获取任何日期范围的详细API使用情况报告

主要优势

• 🚀 快速集成：使用MCP兼容客户端快速设置
• 🔒 安全：支持环境变量的API密钥管理
• 📊 广泛覆盖：访问官方Node SDK公开的适用于MCP工具的所有主要ZeroBounce API端点
• 🎯 准确的：业界领先的电子邮件验证准确性
• 🔄 实时：即时验证和评分结果

快速开始

1. 全局安装MCP服务器

npm install -g @zerobounce/mcp

这将安装 zerobounce-mcp 全球指挥。

1. 获取ZeroBounce API密钥 从 ZeroBounce仪表板

1. 添加到您的MCP客户端 （光标、VS代码、克劳德桌面等）：

{
  "mcpServers": {
    "zerobounce": {
      "command": "zerobounce-mcp",
      "args": ["--api-key=YOUR_API_KEY"]
    }
  }
}

1. 开始使用它 在您的AI助手中：

Validate the email address "test@example.com"

获取API密钥

您的ZeroBounce API密钥在ZeroBounce仪表板中可用：

• 登录 转到您的ZeroBounce帐户
• 导航 到API/开发人员或集成部分
• 创建或复制 此集成的API密钥
• 使用不同的按键 尽可能用于开发、分期和生产

注： 将API密钥视为密码。不要共享它或将其提交给版本控制。

MCP客户端配置

大多数MCP兼容客户端使用相同的基本配置形状。一个最小的例子看起来像：

{
  "mcpServers": {
    "zerobounce": {
      "command": "zerobounce-mcp",
      "args": ["--api-key=YOUR_API_KEY"]
    }
  }
}

在下面选择您的客户，以获取详细的、特定于客户的设置步骤：

• 光标 –为游标IDE配置ZeroBounce MCP
• VS Code –为Visual Studio代码配置ZeroBounce MCP
• 其他/通用客户端 –为Claude Desktop、Continue、Zed等配置ZeroBounce MCP

工具

ZeroBounce MCP服务器提供以下按类别组织的工具：

验证工具

validate_email

使用ZeroBounce API验证单个电子邮件地址。返回详细的验证结果，包括状态、子状态和其他元数据。

validate_batch

批量验证多个电子邮件地址。一次验证多封电子邮件更有效。

帐户工具

get_credits

获取您的ZeroBounce帐户中剩余的信用点数。

get_api_usage

获取某个日期范围的API使用情况统计信息。按状态和子状态显示验证计数。

批量验证文件工具

bulk_validate_send_file

发送CSV文件以进行批量电子邮件验证。返回用于跟踪的文件ID。

bulk_validate_file_status

获取批量验证文件上传的状态。

bulk_validate_get_file

获取已完成的批量验证文件的结果。

bulk_validate_delete_file

从您的帐户中删除批量验证文件。

AI评分工具

bulk_ai_scoring_send_file

发送CSV文件进行批量AI电子邮件评分。返回文件ID进行跟踪。

bulk_ai_scoring_file_status

获取批量AI评分文件上传的状态。

bulk_ai_scoring_get_file

获取完整的批量AI评分文件的结果。

bulk_ai_scoring_delete_file

从您的帐户中删除批量AI评分文件。

电子邮件查找工具

find_email

根据域、名称和/或公司查找电子邮件地址。

注： 批量电子邮件查找器文件操作不能通过官方的Node SDK获得，也不能作为MCP工具公开。

域名搜索工具

domain_search

在域中搜索电子邮件地址。

注： 批量域搜索文件操作无法通过官方Node SDK获得，也不会作为MCP工具公开。

活动数据工具

get_activity_data

获取电子邮件地址的活动数据，查看其最近是否处于活动状态。

限制和不支持的端点

• 自定义过滤器/过滤器管理：不可通过官方的ZeroBounce Node SDK获得，因此不作为MCP工具公开。
• 列表评估员：Node SDK不支持List Evaluator终结点，并且此MCP服务器中未实现该终结点。
• 每封电子邮件的人工智能评分工具：目前，人工智能评分仅通过批量CSV文件操作支持，而不是作为单个电子邮件评分工具。

资源

服务器提供以下资源：

zerobounce://config

当前ZeroBounce API配置（基本URL和是否配置了API密钥）。

使用示例

基本电子邮件验证

验证单个电子邮件：

Validate the email address "test@example.com"

使用IP地址进行验证以提高准确性：

Validate "test@example.com" from IP address "192.168.1.1"

批量验证多封电子邮件：

Check if these emails are valid: ["user1@example.com", "user2@example.com", "user3@example.com"]

账户管理

检查剩余学分：

How many credits do I have left in my ZeroBounce account?

获取使用统计数据：

Show me my ZeroBounce API usage for January 2024

显示特定日期的使用情况：

Get my API usage from 2024-01-01 to 2024-01-31

AI电子邮件评分

通过CSV上传对电子邮件进行评分：

Use AI to score the quality and deliverability of these email addresses and return the results as a CSV: [paste CSV content]

电子邮件查找

按名称和域查找电子邮件：

Find the email for John Doe at example.com

按姓名和公司查找电子邮件：

Find the email for John Doe at Example Corp (example.com)

域搜索

在域中搜索电子邮件：

Search for all email addresses at example.com

使用筛选器搜索：

Find emails for people named John at example.com

活动数据

检查电子邮件活动：

Check if test@example.com has been active recently

批量操作

上传文件进行批量验证：

Bulk validate the emails in this CSV file: [paste CSV content]

检查批量验证状态：

Check the status of my bulk validation file abc123

获取批量验证结果：

Get the results for my completed bulk validation file abc123

状态值

ZeroBounce返回以下状态值：

• 有效的：电子邮件地址有效
• 无效：电子邮件地址无效
• 包罗万象：域名接受所有电子邮件（包罗万象）
• do_not_mail：电子邮件地址在禁止邮寄列表中
• 垃圾收集器：电子邮件地址是垃圾邮件
• 滥用：电子邮件地址与滥用有关
• 未知：无法确定有效性

子状态值

常见的子状态值包括：

• 有毒的：电子邮件地址包含有毒词语
• 一次性：电子邮件地址来自一次性电子邮件服务
• 基于角色：电子邮件地址是基于角色的（例如admin@、info@）
• 可能的陷阱：电子邮件地址可能是一个陷阱
• 全局抑制：电子邮件地址在全局抑制列表中
• 超时_已超过：超过验证超时
• 邮件服务器临时错误：临时邮件服务器错误
• 邮件服务器未回复：邮件服务器没有响应
• 灰色列表：电子邮件地址显示为灰色
• 反垃圾邮件系统：被反垃圾邮件系统阻止
• does_not_accept_mail：域不接受邮件
• 发生例外：验证过程中发生异常
• 语法检查失败：电子邮件语法检查失败
• 邮箱配额已超出：邮箱配额已超出
• 可能_类型：电子邮件地址可能存在拼写错误
• 不可变\_ ip地址：无法路由的IP地址
• 引线周期已移除：领先期已删除
• does_not_accept_mail_from_mailer_demon：不接受来自邮件程序守护进程的邮件
• address_is_blocked：地址被阻止
• 反垃圾邮件检查失败：反垃圾邮件检查失败
• mailbox_not_found：未找到邮箱
• 不可更改的邮件服务器：无法路由的邮件服务器
• 无效：电子邮件地址无效
• 邮件服务器_未响应_超时_周期内：邮件服务器未在超时内响应
• 地址验证失败：地址验证失败
• mailbox_storage_已超过：邮箱存储空间已超出
• 邮箱_管理_已禁用：邮箱在管理上已禁用
• 域名_未找到：找不到域
• address_is_on_a_global_suppress_list：地址在全局抑制列表中

安全最佳实践

保护您的API密钥

您的ZeroBounce API密钥是敏感的，应该受到保护：

1. 从不提交API密钥：将具有API密钥的配置文件添加到 .gitignore

   mcp.json
   .env

1. 使用单独的密钥：使用不同的API密钥进行开发、阶段和生产

1. 定期旋转按键：从ZeroBounce面板定期旋转API键

1. 监视器使用情况：定期检查API的使用情况，以检测未经授权的访问

发展

对于此MCP服务器上的本地开发：

• 安装依赖项：

  npm install

• 构建项目：

  npm run build

• 全局安装CLI（可选，用于本地测试）：

  npm install -g .

在此之后，您可以使用 zerobounce-mcp MCP客户端配置中的命令，例如：

  {
    "mcpServers": {
      "zerobounce": {
        "command": "zerobounce-mcp",
        "args": ["--api-key=YOUR_API_KEY"]
      }
    }
  }

错误处理

服务器优雅地处理错误并返回描述性错误消息：

常见错误

错误响应格式

错误以结构化格式返回：

{
  "error": "Error type",
  "message": "Detailed error description",
  "details": "Additional context (if available)"
}

______________________________________________________________________

由...制作❤️ 对于MCP社区