Mail Notification MCP

Un servidor MCP que envía correos de progreso de proyectos y de aprobación humana mediante SMTP. Utiliza el transporte estándar stdio, adecuado para ser invocado por clientes MCP como Codex, Claude Desktop, Cursor, VS Code, etc.

Herramientas proporcionadas

• send_progress_update: envía informes de progreso, finalización o bloqueo del proyecto.

• request_human_approval: envía elementos que requieren aprobación/rechazo humano y genera un número de aprobación.

• send_simple_email envia correos normales de texto plano o HTML.

• send_custom_email : envía correos personalizados con CC/BCC y adjuntos.

• test_smtp_connection: prueba la conexión y la autenticación SMTP.

• test_imap_connection: prueba la conexión y la autenticación IMAP.

• read_replies: lee las respuestas más recientes de la bandeja de entrada; por defecto no las marca como leídas.

• check_approval_status: identifica “aprobado”, “rechazado” o “pendiente” según el número de aprobación.

• wait_for_approval: espera comprobando periódicamente la respuesta humana hasta que se apruebe, se rechace o expire el tiempo.

Los destinatarios por defecto de las herramientas de progreso proceden de config.json; los correos de aprobación solicitan explícitamente responder “aprobado” o “rechazado”. Otros proyectos solo necesitan invocar las herramientas MCP, sin tener que implementar SMTP por su cuenta.

Related MCP server: mcp-email-server

1. Configurar el SMTP y el buzón de destino

Edite config.json en la raíz del proyecto (plantilla en config.example.json):

{
  "smtp": {
    "host": "smtp.gmail.com",
    "port": 587,
    "secure": false,
    "username": "你的发件邮箱@gmail.com",
    "password": "",
    "password_env": "MAIL_SMTP_PASSWORD",
    "from_email": "你的发件邮箱@gmail.com"
  },
  "imap": {
    "host": "imap.gmail.com",
    "port": 993,
    "secure": true,
    "username": "你的发件邮箱@gmail.com",
    "password": "",
    "password_env": "MAIL_SMTP_PASSWORD"
  },
  "notification": {
    "to": "目标收件邮箱@example.com",
    "subject_prefix": "[工程通知]",
    "project_name": "我的工程"
  }
}

Se recomienda colocar la contraseña en una variable de entorno en lugar de escribirla directamente en el archivo:

$env:MAIL_SMTP_PASSWORD = "你的邮箱应用专用密码"

También puede cumplimentar directamente smtp.password. config.json está ignorado en .gitignore y no debe enviarse al repositorio.

Configuración SMTP común:

Gmail, QQ, etc. normalmente requieren activar SMTP y usar una contraseña específica para la aplicación. Si no se puede utilizar directamente la contraseña de inicio de sesión web, genere un código de autorización o una contraseña de aplicación según los requisitos del proveedor.

El IMAP se usa para leer las respuestas. Los usuarios de QQ suelen usar imap.qq.com:993 + SSL; si se proporciona; si se omite imap.password, el programa reutilizar cielo la contraseña/código de autorización SMTP. Las variables de entorno tienen prioridad sobre config.json. También puede utilizar IMAP_HOST, IMAP_PORT, IMAP_SECURE, IMAP_USER, IMAP_PASS y NOTIFY_TO.

2. Instalación y prueba

Se requiere Python 3.11+ y uv. Ejecute en PowerShell:

cd C:\AI_Tools\Mail
uv sync --extra dev
uv run pytest
uv run python -m email_mcp_server.server

El modo stdio de MCP no debe ingresar texto normal manualmente; es iniciado por el cliente MCP. Se recomienda primero llamar a test_smtp_connection y test_imap_connection.

3. Integración con otros proyectos

Tomando como ejemplo un cliente compatible con el formato mcpServers, integre el siguiente elemento de servidor en la configuración del cliente. Las rutas Windows deben usar doble barra invertida:

{
  "mcpServers": {
    "mail-notification": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\AI_Tools\\Mail",
        "run",
        "python",
        "-m",
        "email_mcp_server.server"
      ]
    }
  }
}

Si uv no está en el PATH del cliente, sustituya command por la ruta absoluta de uv.exe. Después de modificar la configuración MCP, reinicie el cliente.

Ejemplo de llamada

Informe de progreso:

调用 send_progress_update：
project="订单系统"
status="进行中"
summary="已完成数据库迁移脚本，并通过本地测试"
details="迁移了 12 张表，新增回滚检查"
next_steps="部署到测试环境并等待接口联调"

Aprobación humana:

调用 request_human_approval：
project="订单系统"
title="是否允许部署到生产环境"
request="请批准今晚 22:00 执行生产部署"
reason="测试环境已通过，预计需要 15 分钟，期间会短暂重启服务"
options="批准部署 / 延后到明天"
deadline="今天 21:30 前"

Gile

• Las herramientas admiten el parámetro opcional to para sobrescribir el destinatario de una vez; si se omite, se usa notification.to en config.json.

Lectura de respuestas:

调用 read_replies：
from_address="target@example.com"
subject_contains="Mail Notification MCP 测试邮件"
since_hours=72

Confirmación de aprobación:

调用 check_approval_status：
approval_id="APR-ABC1234567"

El estado devuelto por las herramientas de aprobación es approved, rejected, pending o timeout. Por defecto, solo se lee INBOX y no se modifica automáticamente el estado de leído del correo.

Notas de seguridad

• Priorice el uso de contraseñas específicas de la aplicación o códigos de autorización; no utilice la contraseña principal del buzón.

• No comentas a Git contraseñas reales ni la configuración con destinos reales.

• El modo por defecto es stdio local; el modo HTTP solo se vincula a 127.0.0.1.