Atdata Email Verification MCP Server

🚀 AtData SafeToSend MCP Server

AtDataのSafeToSend APIを使用してメール検証サービスを提供するModel Context Protocol (MCP)サーバーです。このサーバーを使用すると、メールアドレスを検証して無効または高リスクのアドレスをフィルタリングでき、オープン率、クリック率、コンバージョン率を向上させることができます。

https://docs.atdata.com/reference/safe-to-send

✨ 主な機能

• メール検証：AtDataのSafeToSend APIを使用して個々のメールアドレスを検証します。
• バッチ検証：要約統計情報付きで複数のメールアドレスを一度に検証します。
• 包括的なエラーハンドリング：さまざまな失敗シナリオに対する詳細なエラーメッセージを提供します。
• 環境変数サポート：環境変数を通じた安全なAPIキー管理を行います。
• レート制限対応：APIのレート制限を適切に処理します。

📦 インストール

1. このリポジトリをクローンします：

git clone <repository-url>
cd atdata-mcp-server

2. uv（推奨）またはpipを使用して依存関係をインストールします：

# uvを使用する場合
uv sync

# pipを使用する場合
uv pip install .

🛠️ セットアップ

AtData APIキーの取得

1. https://atdata.comでAtDataアカウントにサインアップします。
2. AtDataダッシュボードからAPIキーを取得します。
3. APIキーを環境変数として設定します：

export ATDATA_API_KEY="your-api-key-here"

または、プロジェクトのルートに.envファイルを作成します：

ATDATA_API_KEY=your-api-key-here

💻 使用例

サーバーの起動

方法1：直接Pythonで実行

python server.py

方法2：FastMCP CLIを使用

fastmcp run server.py

方法3：Claude Desktop用にインストール

fastmcp install server.py

uvを使用する場合

uvを使用している場合は、以下のようにサーバーを実行することもできます：

{
  "mcpServers": {
    "atdata-email-verification-mcp-server": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/path/to/your/atdata-email-verification-mcp-server",
      "env": {
        "ATDATA_API_KEY": "your_api_key_here"
      }
    }
  }
}

利用可能なツール

1. verify_email

単一のメールアドレスを検証します。

パラメーター:

• email (文字列、必須): 検証するメールアドレス
• api_key (文字列、オプション): AtData APIキー（指定されていない場合は環境変数を使用）

例:

{
    "email": "user@example.com",
    "api_key": "your-api-key"  # ATDATA_API_KEYが設定されている場合はオプション
}

レスポンス:

{
    "success": True,
    "email": "user@example.com",
    "verification_result": {
        "email": "user@example.com",
        "status": "valid",
        "deliverable": True,
        "risk_level": "low",
        # AtData APIからの追加の検証詳細
    }
}

2. batch_verify_emails

複数のメールアドレスをバッチで検証します。

パラメーター:

• emails (文字列の配列、必須): 検証するメールアドレスのリスト
• api_key (文字列、オプション): AtData APIキー（指定されていない場合は環境変数を使用）

例:

{
    "emails": ["user1@example.com", "user2@domain.com", "invalid@email"],
    "api_key": "your-api-key"  # ATDATA_API_KEYが設定されている場合はオプション
}

レスポンス:

{
    "results": [
        {
            "success": True,
            "email": "user1@example.com",
            "verification_result": { /* 検証詳細 */ }
        },
        {
            "success": True,
            "email": "user2@domain.com", 
            "verification_result": { /* 検証詳細 */ }
        },
        {
            "error": "Bad request. Please check the email format.",
            "email": "invalid@email",
            "status_code": 400
        }
    ],
    "summary": {
        "total": 3,
        "successful": 2,
        "failed": 1,
        "success_rate": 66.67
    }
}

🔧 エラーハンドリング

サーバーは、さまざまなシナリオに対する包括的なエラーハンドリングを提供します：

• APIキーが欠落している場合：APIキーが提供されていないときにエラーを返します。
• 認証エラー：無効なAPIキー（401ステータス）を処理します。
• 不正なリクエスト：無効なメール形式（400ステータス）を処理します。
• レート制限：APIのレート制限超過（429ステータス）を処理します。
• ネットワーク問題：接続エラーやタイムアウトを処理します。
• 予期しないエラー：予期しない例外をキャッチして報告します。

📚 ドキュメント

このサーバーはAtData SafeToSend APIに基づいています。基礎となるAPIの詳細については、以下を参照してください：

• AtData SafeToSend APIドキュメント

🛠️ 開発

プロジェクト構造

atdata-mcp-server/
├── src/
│   └── server.py          # メインのMCPサーバー実装
├── pyproject.toml         # プロジェクト構成と依存関係
├── uv.lock               # ロックされた依存関係
└── README.md             # このファイル

👥 コントリビュート

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. 適用可能な場合はテストを追加します。
5. プルリクエストを送信します。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細についてはLICENSEファイルを参照してください。

🆘 サポート

以下に関連する問題について：

• このMCPサーバー：このリポジトリで問題を報告してください。
• AtData API：AtDataサポートに問い合わせるか、そのドキュメントを確認してください。
• FastMCPフレームワーク：FastMCPドキュメントを確認してください。