MailDevMcp
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"
}
}
}
}Переменные окружения
Переменная | По умолчанию | Описание |
|
| Номер порта для REST API MailDev |
Типичный рабочий процесс
Вызовите
StartMaildev, чтобы запустить локальный контейнер MailDevЗапустите отправку письма из вашего приложения
Вызовите
WaitForEmail, если доставка асинхроннаяИспользуйте
ListEmails,SearchEmailsилиGetEmail, чтобы просмотреть результатИспользуйте
GetEmailHtml,GetAttachmentContentилиVerifyAttachment, когда требуется более глубокая проверкаОчистите с помощью
DeleteEmail,DeleteAllEmailsилиStopMaildev
Доступные инструменты
Инструмент | Описание |
| Запускает Docker-контейнер MailDev с настраиваемыми SMTP-портом, портом API, аутентификацией и TLS |
| Останавливает и удаляет Docker-контейнер MailDev |
| Проверяет статус запуска MailDev |
| Получает список полученных писем |
| Получает сведения о письме по ID, включая информацию о вложениях |
| Получает HTML-тело письма по ID |
| Ищет полученные письма по теме, отправителю или получателю |
| Удаляет одно письмо по ID |
| Удаляет все полученные письма |
| Ожидает появления нового письма, соответствующего заданным критериям (полезно для автоматизации тестирования) |
| Получает необработанное содержимое вложения письма в кодировке Base64 |
| Проверяет, что вложение письма совпадает с исходными данными при побайтовом сравнении |
Примечания о поведении инструментов
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Лицензия
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read the verification code (OTP) and test emails your app sends to a catch-all test hostname. Four read-only tools: list_domains, get_latest_otp, list_messages, get_message. Needs a MailBots API key from the 14-day free trial (no card, no DNS) or a paid plan. Setup: https://mailbots.top/docs/mcp
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Email: search, read, fetch attachments; attach files when the MCP client supports inputs.
Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides MCP tools for setting up and managing Hephaestus development environment with Docker containers, including starting/stopping services, initializing databases, and troubleshooting.79 PyPIMIT
- AlicenseAqualityDmaintenanceDeprecated MCP server wrapper for ms365-email-cli that exposes Microsoft 365 email operations (list, read, send, reply, search, etc.) as MCP tools. Use the main ms365-email-cli package instead, which now includes built-in MCP server support.1012 npmISC
- FlicenseNot gradedqualityCmaintenanceCentralizes Thunderbird email operations as MCP tools: read, send, draft, search, attachments.-
- FlicenseAqualityDmaintenanceProvides a dummy SMTP server for catching emails during development, with MCP tools to list, retrieve, and manage received messages.4-