MailboxValidator MCP サーバー

これは、MailboxValidator API 用のシンプルな Model Context Protocol (MCP) サーバーの実装です。メールアドレスの検証結果を返します。

機能

• 包括的なメール検証: 構文、DNS、MX サーバー、高リスク、配信停止リストなどをチェックし、メールアドレスに到達可能かどうかを確認します。

• 使い捨てメールの判定: 一時的/使い捨てメールプロバイダーからのメールアドレスかどうかをチェックします。

• フリーメールの判定: 無料メールプロバイダーからのメールアドレスかどうかをチェックします。

要件

この MCP サーバーには API キーが必要です。無料の API キーにサインアップして、月間最大 300 クエリまで利用することも可能です。

セットアップには Node.js と npm も使用します。これらは Node.js ウェブサイトからダウンロードできます。

セットアップ

以下の手順に従って、Claude Desktop でこの MCP サーバーを使用します。

1. リポジトリをローカルにダウンロードします。

2. プロジェクトフォルダー内で以下のコマンドを実行し、依存関係をインストールしてサーバーをビルドします。

npm install
npm run build

3. Claude Desktop がインストールされていることを確認してください。まだインストールしていない場合は、Windows および MacOS ユーザーはこちらからダウンロードするか、Linux ユーザーはこちらのガイドに従ってください。

4. お好みのエディターで claude_desktop_config.json を開きます。まだ作成していない場合は、こちらのガイドに従って作成してください。

5. claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "mailboxvalidator": {
      "command": "node",
      "args": [
        "C:\\path\\to\\mcp-mailboxvalidator\\build\\index.js"
      ],
      "env": {
        "MAILBOXVALIDATOR_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

6. index.js へのパスを、ローカルマシン上の MailboxValidator MCP サーバーへの実際のパスに置き換えてください。

7. API キーを取得するには、ダッシュボードにログインして取得してください。上記の設定内の <YOUR_API_KEY> を実際の API キーに置き換えてください。

8. 変更を保存した後、Claude Desktop を再起動すると、Search and tools メニューに表示されるはずです。

使用方法

Claude Desktop のチャットで、メールアドレスに関するクエリを入力するだけです。クエリの例をいくつか挙げます。

• (email) は有効なメールアドレスですか？

• (email) は偽のメールアドレスですか？

• (email) はフリーメールですか？

Claude Desktop では、モデルが MailboxValidator MCP サーバーから返された結果に基づいて、自動的に出力を生成します。

環境変数

MAILBOXVALIDATOR_API_KEY

無料の MailboxValidator API キーでは、月間最大 300 件のメールをクエリできます。それ以上必要な場合は、有料の API プランにサインアップしてください。

ツール

validate_email

説明 指定されたメールアドレスを検証します。構文、DNS、MX サーバー、使い捨てリストなどをチェックすることで、メールアドレスが到達可能かどうかを判断するのに役立ちます。

引数 email (str): 検証するメールアドレス。

戻り値 検証データを含む JSON 文字列。結果には以下のフィールドが含まれます。

• Syntax: メールアドレスが正しい形式に従っているかを確認します。

• DNS & MX Server: ドメインの DNS に MX サーバーが指定されているかを確認します。

• Network & Connectivity: MX サーバーへの接続を試行し、動作しているかを確認します。

• Greylisting: MX サーバーがグレイリスティングを使用しており、そのアドレスへのメール送信がバウンスする可能性があるかを確認します。

• Disposable List: メールドメインが一時的または使い捨てのメールプロバイダーのものかを確認します。

• High Risk & Suppressed List: メールのユーザー名が高リスクに見えるか、またはメールアドレスが配信停止リストに含まれているかを確認します。

• Others: メールのレピュテーションスコアなどを確認します。

リクエストが失敗した場合、ツールはエラーメッセージを文字列として返します。

check_disposable_email

説明 指定されたメールアドレスが使い捨てメールプロバイダーのものかどうかをチェックします。

引数 email (str): チェックするメールアドレス。

戻り値 使い捨てメールデータを含む JSON 文字列。結果には以下のフィールドが含まれます。

• Disposable List: メールドメインが一時的または使い捨てのメールプロバイダーのものかを確認します。

リクエストが失敗した場合、ツールはエラーメッセージを文字列として返します。

check_free_email

説明 指定されたメールアドレスが無料メールプロバイダーのものかどうかをチェックします。

引数 email (str): チェックするメールアドレス。

戻り値 フリーメールデータを含む JSON 文字列。結果には以下のフィールドが含まれます。

• Free Email List: メールドメインが無料メールプロバイダーのものかを確認します。

リクエストが失敗した場合、ツールはエラーメッセージを文字列として返します。

ライセンス

LICENSE ファイルを参照してください。