MailDevMcp

Английский | 日本語

mcp-name: io.github.pierre3/maildev-mcp

Сервер MCP (Model Context Protocol) для MailDev.
Управляйте Docker-контейнерами MailDev и просматривайте полученные письма прямо из редактора с искусственным интеллектом или MCP-клиента.

Этот сервер предназначен для сценариев локальной разработки и автоматизации тестирования, когда MCP-клиенту необходимо:

• запустить или остановить контейнер MailDev

• просмотреть содержимое входящих

• дождаться писем после запуска поведения приложения

• просмотреть HTML-тела писем и вложения

• проверить целостность вложений побайтово

Установка

Установите как глобальный инструмент .NET:

dotnet tool install -g MailDevMcp

После установки становится доступной команда maildev-mcp.

Related MCP server: @injaan.dev/ms365-email-cli-mcp

Конфигурация MCP-клиента

Добавьте следующее в настройки вашего MCP-клиента (например, Claude Desktop, VS Code и т. д.):

{
  "mcpServers": {
    "maildev-mcp": {
      "command": "maildev-mcp",
      "env": {
        "MAILDEV_API_PORT": "1080"
      }
    }
  }
}

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

Типичный рабочий процесс

1. Вызовите StartMaildev, чтобы запустить локальный контейнер MailDev

2. Запустите отправку письма из вашего приложения

3. Вызовите WaitForEmail, если доставка асинхронная

4. Используйте ListEmails, SearchEmails или GetEmail, чтобы просмотреть результат

5. Используйте GetEmailHtml, GetAttachmentContent или VerifyAttachment, когда требуется более глубокая проверка

6. Очистите с помощью DeleteEmail, DeleteAllEmails или StopMaildev

Доступные инструменты

Примечания о поведении инструментов

• StartMaildev

  • Поддерживает настраиваемые SMTP-порт и порт API

  • Поддерживает необязательную SMTP-аутентификацию

  • Рассматривает пустые учетные данные или учетные данные, состоящие только из пробелов, как отключенную аутентификацию

  • Поддерживает TLS с сгенерированным самозаверяющим сертификатом

• GetEmail и ListEmails

  • Отображает отсутствующие или пустые темы как (no subject)

  • Отображает отсутствующие списки адресов как (none)

• WaitForEmail

  • Опрашивает MailDev, пока не придет подходящее письмо или не истечет тайм-аут

  • Сообщает о временных сбоях подключения к MailDev в возвращаемом сообщении, если они возникают во время опроса

• VerifyAttachment

  • Принимает исходные данные в кодировке Base64

  • Сравнивает полученное вложение побайтово

  • Сообщает о точном совпадении, несовпадении размера или несовпадении содержимого

Требования и допущения

• Docker должен быть установлен и доступен на той же машине, где работает этот MCP-сервер

• MailDev доступен через его HTTP API на localhost

• Настроенный порт API в MCP-клиенте должен совпадать с портом API MailDev, открытым Docker

Предварительные требования

• .NET 10 SDK или новее

• Docker (для запуска контейнера MailDev)

Сборка из исходного кода

git clone https://github.com/pierre3/MailDevMcp.git
cd MailDevMcp
dotnet pack -c Release
dotnet tool install -g --add-source ./bin/Release MailDevMcp

Лицензия

MIT