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 ファイルを参照してください。