MCP-сервер MailboxValidator

Это простая реализация сервера протокола контекста модели (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.