MCP-сервер MailboxValidator

Это простая реализация сервера Model Context Protocol (MCP) для API MailboxValidator. Он возвращает результат проверки адреса электронной почты.

Функции

• Комплексная проверка электронной почты: проверка адреса электронной почты на доступность путем анализа синтаксиса, DNS, MX-сервера, высокого риска, списков блокировки и многого другого.

• Одноразовая электронная почта: проверка адреса электронной почты на принадлежность к провайдеру временных/одноразовых почтовых ящиков.

• Бесплатная электронная почта: проверка адреса электронной почты на принадлежность к провайдеру бесплатных почтовых услуг.

Требования

Для работы этого MCP-сервера требуется API-ключ. Вы можете зарегистрироваться, чтобы получить бесплатный API-ключ и выполнять до 300 запросов в месяц.

Для настройки также используются Node.js и npm, которые можно загрузить на веб-сайте Node.js.

Настройка

Выполните следующие шаги, чтобы использовать этот MCP-сервер с Claude Desktop:

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 на ваш фактический путь к MCP-серверу MailboxValidator на вашем локальном компьютере.

7. Чтобы получить API-ключ, просто войдите в свою панель управления. Замените <YOUR_API_KEY> в приведенном выше коде на ваш фактический API-ключ.

8. Перезапустите Claude Desktop после сохранения изменений, и он должен появиться в меню Search and tools.

Использование

Просто введите запрос об адресе электронной почты в чате Claude Desktop. Примеры запросов:

• Является ли (email) валидным адресом электронной почты?

• Является ли (email) поддельным адресом?

• Является ли (email) бесплатным почтовым ящиком?

В Claude Desktop модель автоматически сгенерирует вывод на основе результата, возвращенного MCP-сервером MailboxValidator.

Переменная окружения

MAILBOXVALIDATOR_API_KEY

Бесплатный API-ключ MailboxValidator позволяет выполнять до 300 запросов в месяц. Если вам нужно больше, вы можете оформить подписку на платный тарифный план.

Инструмент

validate_email

Описание Проверяет указанный адрес электронной почты. Помогает пользователям определить, является ли адрес потенциально доступным, проверяя синтаксис, DNS, MX-сервер, список одноразовых адресов и многое другое.

Аргументы email (str): Адрес электронной почты для проверки.

Возвращаемые значения JSON-строка, содержащая данные проверки. Результат включает следующие поля:

• Syntax: Проверка соответствия адреса электронной почты стандартному формату.

• DNS & MX Server: Проверка наличия указанного MX-сервера в DNS домена.

• Network & Connectivity: Попытка подключения к MX-серверу для проверки его работоспособности.

• Greylisting: Проверка использования MX-сервером «серого списка» (greylisting), который может привести к возврату письма.

• 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.