AtData SafeToSend MCP Server

AtData SafeToSend MCP サーバー

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 を使用して依存関係をインストールします：

# Using uv
uv sync

# Using 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": "[email protected]",
    "api_key": "your-api-key"  # Optional if ATDATA_API_KEY is set
}

レスポンス：

{
    "success": True,
    "email": "[email protected]",
    "verification_result": {
        "email": "[email protected]",
        "status": "valid",
        "deliverable": True,
        "risk_level": "low",
        # Additional verification details from AtData API
    }
}

2. batch_verify_emails

複数のメールアドレスを一括で検証します。

パラメーター：

• emails（文字列の配列、必須）：検証するメールアドレスのリスト
• api_key（文字列、任意）：AtData API キー（指定されていない場合は環境変数を使用します）

例：

{
    "emails": ["[email protected]", "[email protected]", "invalid@email"],
    "api_key": "your-api-key"  # Optional if ATDATA_API_KEY is set
}

レスポンス：

{
    "results": [
        {
            "success": True,
            "email": "[email protected]",
            "verification_result": { /* verification details */ }
        },
        {
            "success": True,
            "email": "[email protected]", 
            "verification_result": { /* verification details */ }
        },
        {
            "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）
• ネットワークの問題：接続エラーやタイムアウトを処理します
• 予期しないエラー：予期しない例外を捕捉して報告します

API ドキュメント

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

• AtData SafeToSend API ドキュメント

開発

プロジェクト構成

atdata-mcp-server/
├── src/
│   └── server.py          # Main MCP server implementation
├── pyproject.toml         # Project configuration and dependencies
├── uv.lock               # Locked dependencies
└── README.md             # This file

コントリビューション

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

ライセンス

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

サポート

次の項目に関する問題について：

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