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。