Mailboxvalidator

MailboxValidator MCP サーバー

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

機能

• 包括的なメール検証：構文、DNS、MX サーバー、高リスク、抑制リストなどを確認し、メールアドレスにメールを届けられるかを検証します。
• 使い捨てメール：メールアドレスが一時的なメールプロバイダーのものかを確認します。
• フリーメール：メールアドレスが無料メールプロバイダーのものかを確認します。

必要条件

この MCP サーバーには API キーが必要です。登録して無料の API キーを取得すると、月に最大 300 回までクエリを実行できます。

ローカル MCP サーバーのセットアップには Node.js と npm も必要です。Node.js のウェブサイトからダウンロードできます。

セットアップ

この MCP サーバーの使用方法は 2 通りあります。

• クラウドホスト型 MCP サーバー：ホストされている MailboxValidator MCP サーバーに直接接続します。ローカルへのインストールは不要です。
• ローカル MCP サーバー：サーバーをダウンロードし、ご利用のマシンで実行します。

オプション 1：クラウドホスト型 MCP サーバー

ホストされているサーバーに直接接続する場合は、こちらを使用してください。

方法 A：HTTP による直接接続

MCP クライアントが HTTP 経由のリモートサーバーに対応している場合は、こちらを使用してください。Node.js、npm、npx は不要です。

{
  "mcpServers": {
    "mailboxvalidator": {
      "type": "http",
      "url": "https://mcp.mailboxvalidator.com/mcp",
      "headers": {
        "X-API-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

Claude Code など、クライアントをコマンドラインから設定する場合は、次のコマンドでサーバーを追加できます。

claude mcp add --transport http mailboxvalidator https://mcp.mailboxvalidator.com/mcp --header "X-API-Key: <YOUR_API_KEY>"

方法 B：npx 経由で接続

MCP クライアントがローカル（stdio）サーバーにしか対応していない場合は、こちらを使用してください。mcp-remote パッケージをローカルで実行し、ホストされているサーバーにリクエストを転送します。Node.js が必要です。

{
  "mcpServers": {
    "mailboxvalidator": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.mailboxvalidator.com/mcp",
        "--header",
        "X-API-Key:<YOUR_API_KEY>"
      ]
    }
  }
}

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

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

オプション 2：ローカル MCP サーバー

ご利用のマシンで 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 のチャットで、メールアドレスに関するクエリを入力してください。クエリの例をいくつか示します。

• （メールアドレス）は有効なメールアドレスですか？
• （メールアドレス）は偽のメールアドレスですか？
• （メールアドレス）はフリーメールですか？

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

環境変数

MAILBOXVALIDATOR_API_KEY

無料の MailboxValidator API キーでは、月に最大 300 件のメールアドレスをクエリできます。さらに必要な場合は、有料 API プランに登録してください。

ツール

validate_email

説明 指定されたメールアドレスを検証します。構文、DNS、MX サーバー、使い捨てメールのリストなどを確認し、そのメールアドレスにメールが届く可能性があるかどうかをユーザーが判断できるようにします。

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

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

• 構文：メールアドレスが適切な形式に準拠しているかを確認します。
• DNS と MX サーバー：ドメインの DNS に MX サーバーが指定されているかを確認します。
• ネットワークと接続性：MX サーバーに接続し、稼働していることを確認します。
• グレイリスティング：MX サーバーがグレイリスティングを使用しているかを確認します。これにより、そのアドレス宛てのメールがバウンスすることがあります。
• 使い捨てメールのリスト：メールのドメインが一時的または使い捨てメールのプロバイダーのものかを確認します。
• 高リスクおよび抑制対象のリスト：メールのユーザー名が高リスクに見えるか、メールアドレスが抑制リストに含まれているかを確認します。
• その他：メールのレピュテーションスコアなどを確認します。

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

check_disposable_email

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

引数 email (str)：確認するメールアドレスです。

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

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

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

check_free_email

説明 指定されたメールアドレスが無料メールのプロバイダーのものかを確認します。

引数 email (str)：確認するメールアドレスです。

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

• 無料メールのリスト：メールのドメインが無料メールのプロバイダーのものかを確認します。

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

ライセンス

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