Claude Code

Email checker with Claude Code. MCP Server setup for email verification in Claude.

Claude Code 是 Anthropic 的 CLI 编程助手,可以在您的开发工作流中直接调用 EmailVerify 验证邮箱。

什么是 Claude Code?

Claude Code 是基于终端的 AI 助手,帮助开发者:

编写和调试代码
运行 shell 命令
文件操作
API 交互

设置

方式 1: MCP 服务器(推荐)

将 EmailVerify MCP 服务器添加到 Claude Code:

claude mcp add emailverify -- npx -y @emailverify/mcp-server

或添加到您的 ~/.claude/claude_code_config.json:

{
  "mcpServers": {
    "emailverify": {
      "command": "npx",
      "args": ["-y", "@emailverify/mcp-server"],
      "env": {
        "EMAILVERIFY_API_KEY": "您的-API-密钥"
      }
    }
  }
}

方式 2: EmailVerify CLI

安装 EmailVerify CLI:

npm install -g @emailverify/cli
bv config set api-key 您的_API_密钥

然后 Claude Code 可以直接使用 bv 命令。

使用示例

验证单个邮箱

您: 验证 john@example.com 是否是有效邮箱

Claude Code:

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

使用 verify_email 工具...

✅ john@example.com 有效
- 可送达: 是
- 一次性: 否
- 分数: 0.95

这个邮箱看起来是有效且安全的。

验证多个邮箱

您: 检查我 .env 文件中的这些邮箱

Claude Code:

让我读取您的 .env 文件并验证找到的任何邮箱地址。

读取 .env...
找到 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 | 无效 | 一次性邮箱 |

建议: 将 temp-mail 地址替换为真实邮箱用于测试。

清理邮箱列表

您: 清理 contacts.csv 中的邮箱列表并删除无效地址

Claude Code:

我会处理您的 contacts.csv 文件并验证每个邮箱。

读取 contacts.csv... 找到 150 个邮箱地址。

验证邮箱(可能需要一些时间)...

结果:
- 有效: 142 个邮箱
- 无效: 5 个邮箱
- 未知: 3 个邮箱

创建仅包含有效邮箱的 cleaned_contacts.csv...
完成! 删除了 8 个有问题的邮箱。

删除的无效邮箱:
- fake@asdfgh.xyz (域名不存在)
- test@mailinator.com (一次性)
- bounce@invalid.net (邮箱不存在)
...

提交前检查

您: 在我提交之前,验证我的测试 fixtures 中的测试邮箱

Claude Code:

让我检查您的测试 fixtures 中的邮箱地址。

扫描 test/ 目录...
在 test/fixtures/users.json 中找到邮箱

验证 5 个测试邮箱...

⚠️ 警告: 发现潜在问题:

1. test@mailinator.com - 这是一次性邮箱
   考虑在测试 fixtures 中使用 @example.com (RFC 2606 保留域名)

2. admin@real-company.com - 这似乎是真实公司邮箱
   您可能不想在测试 fixtures 中使用真实邮箱

建议:
- 对测试邮箱使用 @example.com, @example.org
- 使用 user{n}@example.com 模式
- 永远不要在测试中使用真实公司邮箱

工作流模式

Pre-commit Hook

让 Claude Code 为您的工作流设置邮箱验证:

您: 添加一个 pre-commit hook 来验证配置文件中的任何新邮箱地址

Claude Code:

我会创建一个用于邮箱验证的 pre-commit hook。

创建 .husky/pre-commit...

#!/bin/sh
# 检查配置文件中的新邮箱地址
emails=$(git diff --cached --diff-filter=ACMR -- "*.json" "*.yaml" "*.env*" | \
  grep -oE '[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}')

if [ -n "$emails" ]; then
  echo "正在验证新邮箱地址..."
  for email in $emails; do
    result=$(bv verify "$email" --quiet)
    if [ $? -eq 1 ]; then
      echo "❌ 发现无效邮箱: $email"
      exit 1
    fi
  done
  echo "✅ 所有邮箱已验证"
fi

完成! 该 hook 将在每次提交前验证邮箱。

CI/CD 集成

您: 将邮箱验证添加到我的 GitHub Actions 工作流

Claude Code:

我会将邮箱验证步骤添加到您的工作流中。

更新 .github/workflows/ci.yml...

- name: 验证测试邮箱
  env:
    EMAILVERIFY_API_KEY: ${{ secrets.EMAILVERIFY_API_KEY }}
  run: |
    npm install -g @emailverify/cli
    # 从测试 fixtures 中提取并验证邮箱
    grep -rhoE '[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}' test/ | \
      sort -u | while read email; do
        if ! bv verify "$email" --quiet; then
          echo "测试中发现无效邮箱: $email"
          exit 1
        fi
      done

不要忘记将 EMAILVERIFY_API_KEY 添加到您的仓库 secrets。