mailcue-mcp

Un servidor de pruebas de correo realista en un solo contenedor Docker.

---

MailCue empaqueta Postfix, Dovecot, OpenDKIM, OpenDMARC, SpamAssassin, una API REST FastAPI y una interfaz web React en un solo contenedor Docker gestionado por s6-overlay. Ejecuta una pila de correo completa con acceso IMAP/POP3, firma DKIM, verificación DMARC, filtrado de spam, TLS y cifrado GPG, para que puedas probar el correo tal y como se comporta en producción. Establece MAILCUE_MODE=production y el mismo contenedor funciona como un servidor de correo real.

Características · Inicio rápido · Documentación · Contribuciones

Características

Capacidad	Qué hace
SMTP de captura total	Acepta correo para cualquier dirección en cualquier dominio. Nada sale del contenedor.
IMAP y POP3	Lee el correo capturado con cualquier cliente estándar a través de STARTTLS o TLS implícito.
Interfaz web	Aplicación React con barra lateral de buzón, navegación de carpetas, visor de correo y diálogo de redacción.
API REST y SDK	API JSON para enviar, recibir, inyectar, buscar y eliminar correo, con SDK de Python y Node.
Inyección de correo	Inserta mensajes directamente en un buzón mediante IMAP APPEND para una configuración de pruebas determinista, con cabeceras realistas.
Pruebas de entregabilidad	Crea un buzón de puntuación con autenticación, SpamAssassin, contenido, cabeceras y diagnósticos de transporte a través de la interfaz web, la API REST, el SDK de Node y MCP.
DKIM, DMARC, SPF	Firma OpenDKIM, verificación OpenDMARC y comprobaciones de políticas SPF, con cabeceras Authentication-Results.
Filtrado de spam	SpamAssassin puntúa el correo entrante con un umbral configurable, filtrado bayesiano y comprobaciones RBL.
TLS en todas partes	Certificados generados automáticamente para SMTP STARTTLS, IMAPS y POP3S. Sube los tuyos desde la interfaz.
GPG / PGP-MIME	Claves GPG por buzón. Firma, cifra, verifica y descifra correo (RFC 3156). Publica claves en keys.openpgp.org.
Eventos en tiempo real	Un flujo de Server-Sent Events envía email.received, email.deleted, mailbox.created y más.
Claves de API con alcance	Autenticación X-API-Key con alcances por clave (lectura, envío, borrado y más) y una lista de permitidos de buzones opcional.
Servidor MCP	Un servidor oficial de Model Context Protocol da a un agente de IA su propio buzón.
Gestión de dominios	Añade dominios personalizados con DKIM automático y un panel de DNS para MX, SPF, DKIM, DMARC, MTA-STS y TLS-RPT.
Multi-usuario	Cuotas de buzón por usuario y buzones, correos, claves GPG y claves de API aislados.
Modo producción	Un servidor de correo endurecido con dominios estrictos, TLS obligatorio, rechazo DMARC y certificados Let's Encrypt.
Sandbox de proveedores	Captura tráfico saliente de SMS, voz y chat con endpoints idénticos y webhooks firmados.
Base de datos flexible	SQLite sin configuración con cifrado AES-256 opcional, o PostgreSQL externo para cargas de trabajo de producción concurrentes.

Inicio rápido

Docker Compose

git clone https://github.com/Olib-AI/mailcue.git
cd mailcue
docker compose up -d

Abre http://localhost:8088 e inicia sesión con el nombre de usuario admin y la contraseña mailcue.

Docker run

docker run -d \
  --name mailcue \
  -p 8088:80 \
  -p 25:25 \
  -p 587:587 \
  -p 143:143 \
  -p 993:993 \
  -v mailcue-data:/var/mail/vhosts \
  -v mailcue-db:/var/lib/mailcue \
  -e MAILCUE_DOMAIN=mailcue.local \
  -e MAILCUE_ADMIN_PASSWORD=mailcue \
  ghcr.io/olib-ai/mailcue

Comprueba que funciona

curl http://localhost:8088/api/v1/health

Opciones de base de datos

MailCue usa SQLite por defecto, lo que mantiene simples las implementaciones locales y pequeñas. Las instalaciones de producción con tráfico concurrente de API, sandbox de proveedores, HTTP-bin o calentamiento de correo deberían usar PostgreSQL. MailCue admite una base de datos PostgreSQL gestionada o un contenedor PostgreSQL en la misma red Docker privada. Se incluyen agrupación de conexiones, índices de producción, claves foráneas, migraciones automáticas de esquema y un comando de migración offline de SQLite a PostgreSQL.

Consulta Implementación en producción para ejemplos de Docker Compose y el procedimiento de migración. Consulta Configuración para cada variable de entorno de la base de datos.

Documentación

📖 Lee las guías completas e interactivas en el Sitio web oficial de documentación de MailCue.

Guía	Cubre
Arquitectura	Diseño del contenedor, flujo de solicitudes y pila tecnológica.
Configuración	Variables de entorno y puertos expuestos.
Referencia de la API	Endpoints REST, autenticación y alcances de claves de API.
Implementación en producción	Modo endurecido, implementación y migración de PostgreSQL, registros DNS y certificados TLS.
Clientes de correo y confianza TLS	Configuración de IMAP/POP3/SMTP y confianza en la CA.
Uso en CI/CD	Configuración de pipelines y ejemplos de plataformas.
Servidor MCP	Dale a un agente de IA su propio buzón a través de MCP.
Sandbox de proveedores y HTTP bin	Captura tráfico de SMS, voz y chat, e inspecciona solicitudes HTTP.
Compartir MailCue entre proyectos	Ejecuta un contenedor detrás de una red Docker compartida.
Desarrollo y contribuciones	Configuración local, linting, pruebas y proceso de PR.

La API también se sirve como interfaz Swagger interactiva en /api/docs, con especificaciones legibles por máquina en openapi.json y postman_collection.json. Consulta la guía de pruebas de entregabilidad para puntuación, pruebas visuales, ubicación, proveedores, horarios y políticas de CI.

Los SDK y el servidor MCP tienen su propia documentación: SDK de Python, SDK de Node y servidor MCP.

Contribuciones

Las contribuciones son bienvenidas. Consulta Desarrollo y contribuciones para la configuración local, linting, comprobaciones de tipos, pruebas y el proceso de solicitudes de extracción.

Licencia

MIT. Consulta LICENSE.

Historial de estrellas

Enlaces

• Olib AI: www.olib.ai
• GitHub: github.com/Olib-AI/mailcue
• Registro de contenedores: ghcr.io/olib-ai/mailcue
• Documentación de la API: disponible en /api/docs cuando se ejecuta
• Problemas: github.com/Olib-AI/mailcue/issues
• Discusiones: github.com/Olib-AI/mailcue/discussions

---

Si encuentras MailCue útil, considera darle una estrella en GitHub. Ayuda a otros a descubrir el proyecto.

Construido por Olib AI