ZeroBounce MCP Server

ZeroBounce MCP サーバー

ZeroBounce のメール検証サービスと連携するための Model Context Protocol（MCP）サーバーです。公式の ZeroBounce Python API v2 ライブラリを使用します。

機能

• 個別のメールアドレスを検証
• 残りの API クレジットを確認
• 一括検証用のファイルをアップロード
• 一括検証ファイルのステータス確認、取得、削除
• ドメインで使用されているメールパターンを検索

セットアップ

システム要件

• Python 3.10+
• ZeroBounce の API キー

インストール

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

git clone https://github.com/avivshafir/zerobounce-mcp-server
cd zerobounce-mcp-server

2. 必要な依存関係をインストールします。

pip install -r requirements.txt

3. 環境変数を設定します。

   方法 1：.env ファイルを使用する（推奨）

   ZeroBounce の API キーを記載した .env ファイルを作成します。

   ZEROBOUNCE_API_KEY=your_zerobounce_api_key
   

   方法 2：環境変数を直接設定する

   export ZEROBOUNCE_API_KEY="your_zerobounce_api_key"
   

API キーは ZeroBounce アカウントのダッシュボードから取得できます。

mcp.json ファイルに以下の設定を追加し、ディレクトリパスをこのサーバーをインストールした実際のパスに置き換えてください。

{
  "mcpServers": {
    "zerobounce": {
      "command": "python",
      "args": ["/path/to/your/zerobounce-mcp-server/main.py"]
    }
  }
}

4. 変更を適用するため、Cursor を再起動します。

これで、Cursor の AI アシスタントから ZeroBounce MCP サーバーを直接使用できます。

利用可能なツール

このサーバーでは、以下のツールを利用できます。

1. validate_email：単一のメールアドレスを検証

   validate_email(email: str, ip_address: str = "") -> dict
   

2. get_credits：ZeroBounce アカウントの残りのクレジットを確認

   get_credits() -> dict
   

3. upload_file：一括検証用のファイルをアップロード

   upload_file(file_path: str, email_column: int, ...) -> dict
   

4. check_file_status：一括検証ファイルのステータスを確認

   check_file_status(file_id: str) -> dict
   

5. get_file：一括検証の結果を取得

   get_file(file_id: str) -> dict
   

6. delete_file：一括検証ファイルを削除

   delete_file(file_id: str) -> dict
   

7. domain_search：ドメインで使用されているメールパターンを検索

   domain_search(domain: str) -> dict
   

依存関係

• zerobounce-python-api-v2：公式の ZeroBounce API ライブラリ
• python-dotenv：.env ファイルから環境変数を読み込むためのライブラリ
• mcp：Model Context Protocol ライブラリ
• asyncio：非同期処理用