MCP Email Server

Proporciona acceso IMAP y SMTP para enviar y recibir correos electrónicos.

GitHub
347
Prueba este MCPPatrocinado

Documentación

mcp-email-server

Release Build status codecov License

Un servidor MCP para leer, buscar, organizar y enviar correo electrónico a través de IMAP y SMTP.

[!NOTE] La versión 1.0.0 introduce Local Email App V2. Actualizar el paquete no importa automáticamente los ajustes existentes creados con PyPI 0.16.0 y versiones anteriores: permanecen activos en modo legacy compatible con versiones anteriores, por lo que no hay una migración obligatoria. Si desea utilizar el nuevo almacenamiento gestionado, puede revisar e importar esos ajustes cuando le resulte conveniente.

mcp-email-server es compatible con Windows, macOS y Linux. Consulte Seguridad para conocer los detalles específicos de almacenamiento de credenciales y sistema de archivos según la plataforma.

Migración opcional para instalaciones existentes

Una versión de @latest que incluya Local Email App V2 ofrece una migración CLI con vista previa primero:

uvx mcp-email-server@latest config init \
  --database ~/.config/mcp-email-server/managed.sqlite3
uvx mcp-email-server@latest config import-legacy
uvx mcp-email-server@latest config import-legacy --apply
uvx mcp-email-server@latest config doctor

El paso de aplicación muestra el plan nuevamente y solicita confirmación de IMPORT. Una importación completa selecciona el modo gestionado; de lo contrario, los ajustes heredados existentes permanecen seleccionados. El archivo TOML de origen y sus entradas de llavero heredadas se dejan sin modificar. También puede ejecutar uvx mcp-email-server@latest ui y elegir Importar ajustes existentes. Después de una importación exitosa, reinicie los clientes MCP en ejecución. Consulte la guía de actualización detallada y la solución de problemas de importación.

Inicio rápido

1. Configurar una cuenta de correo electrónico

Desde este checkout del código fuente, ejecute la interfaz de configuración con uv:

uv sync
uv run mcp-email-server ui

Para una versión publicada cuyas notas indiquen que incluye Local Email App V2, uvx mcp-email-server@latest ui es la invocación temporal equivalente.

Mantenga el comando en primer plano en ejecución. En una instalación completamente vacía, la sesión de navegador autenticada prepara el almacenamiento privado de la cuenta en el valor predeterminado local seguro; la configuración TOML o de variables de entorno existente ofrece en su lugar una revisión de importación explícita mientras los ajustes anteriores siguen ejecutándose. La interfaz centrada en la cuenta tiene solo Cuentas de correo y Ajustes y ayuda como destinos principales. Comience con la dirección de correo electrónico y la contraseña; la interfaz completa los ajustes de conexión comunes a partir del dominio de correo y los mantiene editables, mientras que el correo saliente sigue siendo opcional. Una cuenta completa guardada está lista sin un paso de activación separado. Use Contraseña y prueba en la cuenta guardada si lo desea, luego reinicie el cliente MCP para aplicar los ajustes seleccionados.

2. Configurar el cliente MCP

Use la misma distribución compatible con V2 para stdio que para la interfaz. Para una versión V2 publicada, agregue la siguiente definición de servidor al cliente MCP:

{
  "mcpServers": {
    "mcp-email-server": {
      "command": "uvx",
      "args": ["mcp-email-server@latest", "stdio"]
    }
  }
}

Reinicie el cliente MCP después de actualizar su configuración. Al probar este checkout del código fuente antes de la publicación, invoque uv run --directory /ruta/absoluta/a/mcp-email-server mcp-email-server stdio en lugar de emparejar un catálogo gestionado con PyPI @latest.

3. Verificar la conexión

Pida al cliente que liste las cuentas de correo configuradas o los mensajes recientes.

Otros métodos de configuración

Para el flujo de trabajo CLI gestionado respaldado por SQLite, los límites de almacenamiento de Windows y POSIX, entornos sin interfaz gráfica, múltiples cuentas, ajustes TLS personalizados y configuración mediante variables de entorno, consulte la documentación. La versión 1.6.2 y posteriores también publican imágenes de Linux amd64/arm64 en ghcr.io/wh1isper/mcp-email-server; consulte las instrucciones para contenedores.

Documentación

Desarrollo

Consulte CONTRIBUTING.md.

Licencia

Este proyecto está licenciado bajo los términos de la LICENCIA.