MCP Server

模型上下文协议 (MCP) 是 Anthropic 推出的开放协议，使 AI 模型能够安全地与外部工具和数据源交互。EmailVerify 通过 HTTP Streamable Transport 标准，为 AI Agent 提供企业级邮箱验证服务，配置极其简单。

为什么 AI Agent 需要邮箱验证？

现代 AI Agent 应用场景：

• Claude Code 处理用户数据时需要验证邮箱地址有效性
• OpenCode 在自动化工作流中需要邮箱验证
• Gemini CLI Agent 处理注册数据时需要质量保证
• Codex 生成的代码需要内置邮箱验证逻辑
• 自定义 AI Agent 与人类交互时需要确认联系方式真实性

EmailVerify MCP 通过 HTTP Streamable Transport 标准，让任何 AI Agent 都能直接调用企业级邮箱验证服务，无需复杂配置。

核心功能

1. 单邮箱实时验证

• 验证邮箱格式、域名、MX 记录
• 可选 SMTP 连接检测
• 一次性邮箱识别
• 公司邮箱 vs 免费邮箱识别
• 角色邮箱识别（support@、noreply@ 等）
• 平均响应时间 < 2 秒

2. 批量邮箱验证

• 一次性验证最多 50 个邮箱
• 并发处理，高效可靠
• 详细的验证结果和统计数据

3. 智能缓存系统

• 有效邮箱缓存 7 天
• 无效邮箱缓存 7 天
• 未知状态缓存 10 分钟
• 减少不必要的重复验证

4. 精确积分计费

• 有效邮箱：1 积分
• 无效邮箱：0 积分（防止浪费）
• 未知状态：0 积分（自动重试）
• 实时余额查询

支持的 AI 客户端

快速设置（HTTP Transport - 推荐）

最简单的集成方式 - 无需安装任何 npm 包！

步骤 1：获取 API Key

访问 EmailVerify 控制面板 创建您的 API 密钥。

步骤 2：配置 Claude Desktop

编辑配置文件：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "emailverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.emailverify.ai/mcp?api_key=YOUR_API_KEY"]
    }
  }
}

将 YOUR_API_KEY 替换为您的实际 API Key，然后重启 Claude Desktop。

就这样！无需 npm install，无需任何依赖。curl 在所有系统上都已预装。Claude 现在拥有邮箱验证能力。

步骤 3：开始验证

在对话中直接说：

请验证这个邮箱：user@example.com

Claude 会自动调用 EmailVerify 并返回详细结果。

Claude Code 设置

对于 Claude Code CLI，添加 MCP 服务器：

claude mcp add emailverify -- curl --stdio "https://mcp.emailverify.ai/mcp?api_key=YOUR_API_KEY"

或添加到您的 ~/.claude.json：

{
  "mcpServers": {
    "emailverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.emailverify.ai/mcp?api_key=YOUR_API_KEY"]
    }
  }
}

OpenCode 设置

在 ~/.opencode/config.json 中配置：

{
  "mcpServers": {
    "emailverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.emailverify.ai/mcp?api_key=YOUR_API_KEY"]
    }
  }
}

Gemini CLI 设置

添加到您的配置：

{
  "mcpServers": {
    "emailverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.emailverify.ai/mcp?api_key=YOUR_API_KEY"]
    }
  }
}

Cursor 设置

在 Cursor 中，转到 Settings > MCP 并添加：

{
  "emailverify": {
    "command": "curl",
    "args": ["--stdio", "https://mcp.emailverify.ai/mcp?api_key=YOUR_API_KEY"]
  }
}

NPX 方式（备选）

如果您更喜欢 npm 包方式：

{
  "mcpServers": {
    "emailverify": {
      "command": "npx",
      "args": ["-y", "@emailverify/mcp-server"],
      "env": {
        "EMAILVERIFY_API_KEY": "your-api-key-here"
      }
    }
  }
}

可用工具

verify_single_email

验证单个邮箱地址，提供全面的验证结果。

参数：

返回：

{
  "email": "user@example.com",
  "status": "valid",
  "score": 1,
  "is_deliverable": true,
  "is_disposable": false,
  "is_catchall": false,
  "is_role": false,
  "is_free": true,
  "domain": "example.com",
  "mx_records": ["has_mx_records"],
  "smtp_check": true,
  "response_time": 2,
  "credits_used": 1
}

在 Claude 中的使用示例：

"检查 test@example.com 是否是有效邮箱"

verify_batch_emails

一次验证多个邮箱地址（最多 50 个）。

参数：

返回：

{
  "total_emails": 2,
  "valid_emails": 2,
  "invalid_emails": 0,
  "results": [...],
  "credits_used": 2,
  "process_time": 4
}

在 Claude 中的使用示例：

"验证这些邮箱：user1@example.com、user2@test.com、info@company.com"

get_account_balance

检查账户积分和使用统计。

参数： 无

返回：

{
  "account_id": "acc_xxx",
  "credits": 944815,
  "total_consumed": 59325,
  "total_added": 1000,
  "last_updated": "2026-01-10T12:32:00Z"
}

在 Claude 中的使用示例：

"我还有多少验证积分？"

使用示例

基础验证

用户:

验证 john@google.com

Claude:

我会为您验证这个邮箱地址。

邮箱验证结果

字段	值
邮箱	john@google.com
状态	有效
可送达	是
一次性	否
分数	0.95

这个邮箱看起来是有效且可送达的。

多个邮箱验证

用户:

检查这些邮箱: john@google.com, test@mailinator.com, support@microsoft.com

Claude:

我会验证所有三个邮箱地址。

邮箱	状态	备注
john@google.com	有效	可送达,企业邮箱
test@mailinator.com	无效	一次性邮箱,建议拒绝
support@microsoft.com	有效	角色邮箱,可能是共享的

建议:

• john@google.com - 安全使用
• test@mailinator.com - 临时邮箱,不推荐
• support@microsoft.com - 有效但可能是团队收件箱

开发者工作流

用户(在 Claude Code 中):

验证我的 .env.example 文件中的测试邮箱

Claude:

我会读取文件并验证找到的任何邮箱地址。

在 .env.example 中找到 3 个邮箱地址:

• TEST_EMAIL=user@example.com
• ADMIN_EMAIL=admin@company.com
• SUPPORT_EMAIL=help@temp-mail.org

验证结果:

邮箱	状态
user@example.com	未知(示例域名)
admin@company.com	有效
help@temp-mail.org	无效(一次性)

考虑使用真实邮箱地址进行测试。

输出格式

MCP 服务器返回格式良好的结果:

## 邮箱验证结果

**邮箱:** test@example.com
**状态:** VALID
**置信度分数:** 95.0%

### 详情
| 检查项 | 结果 |
|-------|--------|
| 可送达 | 是 |
| 格式有效 | 是 |
| 域名有效 | 是 |
| MX 记录有效 | 是 |
| 一次性 | 否 |
| 角色地址 | 否 |
| 全捕获 | 否 |
| 免费提供商 | 否 |

**使用积分:** 1

最佳实践

1. 安全存储 API Key

永远不要硬编码您的 API 密钥。使用环境变量:

{
  "env": {
    "EMAILVERIFY_API_KEY": "${EMAILVERIFY_API_KEY}"
  }
}

2. 使用自然语言

MCP 服务器理解各种表述:

• "验证 user@example.com"
• "test@company.com 是有效邮箱吗?"
• "检查这个邮箱是否可送达: john@test.com"
• "你能帮我验证这些邮箱地址吗?"

3. 尽可能批量处理

对于多个邮箱,请 Claude 一起验证以提高效率:

"一次性验证所有这些邮箱: email1@test.com, email2@test.com, email3@test.com"

故障排除

找不到 MCP 服务器

如果 Claude 说找不到 EmailVerify 工具:

1. 检查您的配置文件路径
2. 确保 JSON 格式有效
3. 完全重启 Claude Desktop
4. 验证您的 API 密钥正确

速率限制错误

如果您看到速率限制错误:

1. 用 "我还有多少积分?" 检查剩余积分
2. 稍等片刻再试
3. 考虑升级您的套餐以获得更高限制

连接问题

如果验证失败:

1. 检查您的网络连接
2. 验证您的 API 密钥有效
3. 先尝试简单的验证

常见问题

我的 API 密钥安全吗?

是的。API 密钥存储在您的本地配置文件中,仅由运行在您机器上的 MCP 服务器使用。它永远不会发送给第三方。

哪些 AI 客户端支持 MCP?

任何兼容 MCP 的客户端都可以工作,包括 Claude Desktop、Claude Code、Cursor、Zed、Cline 和 Continue。

离线时会发生什么?

如果无法访问 EmailVerify API,工具会返回错误消息。这不会影响 Claude 的其他功能。

积分如何计算?

每次邮箱验证使用 1 个积分。批量验证每个邮箱使用 1 个积分。使用 check_credits 工具检查您的余额。

下一步