MailBridge MCP

Seguridad ante todo: inteligencia de correo electrónico de solo lectura para asistentes de IA compatibles con MCP.

MailBridge demuestra cómo un asistente de IA puede buscar en múltiples buzones, reconstruir hilos, inspeccionar adjuntos y preservar el estado del buzón. La distribución pública funciona íntegramente con datos sintéticos, por lo que se puede explorar con seguridad sin credenciales ni acceso a una bandeja de entrada real.

Este repositorio es una distribución pública de referencia controlada por Gexiro Global Enterprises Ltd. No es un espejo de ningún despliegue privado y no contiene configuración de producción, infraestructura, datos de buzones ni credenciales.

Por qué MailBridge

• Once herramientas MCP deliberadamente de solo lectura.

• Contratos estándar search y fetch para compatibilidad con fuentes de conocimiento.

• Esquemas de salida explícitos para cada resultado estructurado de herramienta.

• Widget de MCP Apps con un recurso ui:// versionado.

• Protocolo de inicio ui/initialize y ui/notifications/initialized basado en estándares.

• Comportamiento de búsqueda en múltiples buzones y en todas las carpetas.

• Reconstrucción de hilos mediante Message-ID, In-Reply-To y References.

• Recuperación de adjuntos limitada con sumas de verificación SHA-256.

• Advertencia explícita de que el contenido del correo y de los adjuntos no es de confianza.

• Enlace público a prueba de fallos: solo bucle local a menos que un operador lo habilite explícitamente.

• Cero operaciones SMTP, de envío, movimiento, eliminación, marcado, anexado, copiado o expurgo.

Related MCP server: imap-2-mcp

Superficie de herramientas

Cada descriptor establece readOnlyHint: true, destructiveHint: false, idempotentHint: true y openWorldHint: false.

Inicio rápido

Requisitos: Node.js 24 o superior.

npm ci
npm run check
npm run dev

El servidor se inicia en el bucle local de forma predeterminada:

Health: http://127.0.0.1:3100/health
Widget: http://127.0.0.1:3100/widget
MCP:    http://127.0.0.1:3100/mcp

Para conectarse desde un cliente MCP, use el endpoint HTTP transmisible /mcp. Para pruebas de desarrollo con ChatGPT, exponga el servicio de bucle local a través de un túnel HTTPS revisado y actualice la aplicación después de cambios en los metadatos de herramientas o recursos.

Docker

El contenedor sigue siendo exclusivamente sintético y se ejecuta como el usuario node sin privilegios.

docker build -t mailbridge-mcp .
docker run --rm -p 127.0.0.1:3100:3100 \
  -e MAILBRIDGE_HOST=0.0.0.0 \
  -e MAILBRIDGE_ALLOW_PUBLIC_DEMO=I_UNDERSTAND_SYNTHETIC_ONLY \
  mailbridge-mcp

Arquitectura

flowchart LR
    Host[ChatGPT or MCP host] -->|Streamable HTTP| MCP[MailBridge MCP server]
    MCP --> Tools[Read-only tool contracts]
    MCP --> Widget[MCP Apps dashboard]
    Tools --> Demo[Synthetic mailbox provider]
    Demo --> Guard[Untrusted-content and size guards]

La frontera del proveedor es intencionalmente pequeña. Esta edición pública incluye únicamente el proveedor sintético; los adaptadores de producción, las identidades de operador, el almacenamiento de credenciales y la topología de despliegue quedan fuera de este repositorio.

Propiedades de seguridad

• No existe ninguna entrada de credenciales en ningún esquema de herramienta MCP.

• En esta distribución pública no se implementa ninguna conexión real a buzones.

• Las obtenciones de mensajes no mutan el estado sintético de no leído.

• Los bytes de los adjuntos están limitados y etiquetados como no confiables.

• El runtime HTTP rechaza el enlace fuera del bucle local salvo que se establezca el reconocimiento explícito de demostración sintética.

• CI ejecuta compilación, pruebas, escaneo de secretos del repositorio, auditoría de dependencias, revisión de dependencias, CodeQL, una prueba de humo real del contenedor y validación de SBOM.

• La puerta del contenedor se cierra ante CVEs detectados de gravedad Alta o Crítica y elimina los gestores de paquetes de la imagen de runtime tras la instalación de dependencias.

• Los lanzamientos etiquetados contienen sumas de verificación SHA-256, un SBOM CycloneDX y atestaciones de procedencia de artefactos de GitHub.

Consulte SECURITY.md, THREAT_MODEL.md, PRIVACY.md y ARCHITECTURE.md.

Alineación con OpenAI Apps SDK

La implementación sigue la guía actual de MCP Apps-first:

• el recurso de UI usa text/html;profile=mcp-app;

• las herramientas siguen siendo útiles sin el widget;

• list_mailboxes apunta a un _meta.ui.resourceUri versionado;

• el widget consume ui/notifications/tool-result y usa window.openai.toolOutput solo como vía de compatibilidad;

• los metadatos CSP no declaran dominios externos de conexión o recursos.

Referencias oficiales:

• Crear un servidor MCP

• Añadir UI a tu servidor MCP

• Definir herramientas

• Referencia de plugins

Integridad de los lanzamientos

Cada lanzamiento etiquetado se compila a partir de dependencias bloqueadas en GitHub Actions. Verifique el archivo descargado y el SBOM con el SHA256SUMS incluido y, a continuación, verifique la atestación de artefacto de GitHub con respecto a este repositorio antes de usarlo.

Políticas del proyecto

• Registro de cambios

• Contribución

• Código de conducta

• Soporte

• Seguridad

• Privacidad

Licencia

Licencia Apache 2.0. Copyright © 2026 Gexiro Global Enterprises Ltd.