MailDevMcp

Inglés | 日本語

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

Un servidor MCP (Model Context Protocol) para MailDev.
Gestiona contenedores Docker de MailDev e inspecciona los correos electrónicos recibidos directamente desde tu editor con IA o cliente MCP.

Este servidor está pensado para escenarios de desarrollo local y automatización de pruebas donde un cliente MCP necesita:

• iniciar o detener un contenedor de MailDev

• inspeccionar el contenido de la bandeja de entrada

• esperar correos electrónicos después de desencadenar el comportamiento de una aplicación

• inspeccionar cuerpos HTML y adjuntos

• verificar la integridad de los adjuntos byte a byte

Instalación

Instalar como herramienta global de .NET:

dotnet tool install -g MailDevMcp

Después de la instalación, el comando maildev-mcp estará disponible.

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

Configuración del Cliente MCP

Añade lo siguiente a la configuración de tu cliente MCP (por ejemplo, Claude Desktop, VS Code, etc.):

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

Variables de Entorno

Flujo de Trabajo Típico

1. Llama a StartMaildev para lanzar un contenedor local de MailDev

2. Desencadena el envío de un correo electrónico desde tu aplicación

3. Llama a WaitForEmail si la entrega es asíncrona

4. Usa ListEmails, SearchEmails o GetEmail para inspeccionar el resultado

5. Usa GetEmailHtml, GetAttachmentContent o VerifyAttachment cuando se necesite una validación más profunda

6. Limpia con DeleteEmail, DeleteAllEmails o StopMaildev

Herramientas Disponibles

Notas sobre el Comportamiento de las Herramientas

• StartMaildev

  • Admite puertos SMTP y API personalizados

  • Admite autenticación SMTP opcional

  • Trata las credenciales vacías o solo con espacios en blanco como autenticación deshabilitada

  • Admite TLS con un certificado autofirmado generado

• GetEmail y ListEmails

  • Muestran asuntos faltantes o vacíos como (sin asunto)

  • Muestran listas de direcciones faltantes como (ninguno)

• WaitForEmail

  • Consulta MailDev hasta que llegue un correo electrónico que coincida o se alcance el tiempo de espera

  • Informa fallos transitorios de conexión con MailDev en el mensaje devuelto cuando ocurren durante la consulta

• VerifyAttachment

  • Acepta un payload original codificado en Base64

  • Compara el adjunto recibido byte a byte

  • Informa coincidencia exacta, discrepancia de tamaño o discrepancia de contenido

Requisitos y Suposiciones

• Docker debe estar instalado y disponible en la misma máquina donde se ejecuta este servidor MCP

• Se accede a MailDev a través de su API HTTP en localhost

• El puerto API configurado en el cliente MCP debe coincidir con el puerto API de MailDev expuesto por Docker

Prerrequisitos

• .NET 10 SDK o posterior

• Docker (para ejecutar el contenedor de MailDev)

Compilar desde el Código Fuente

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

Licencia

MIT