Mail Notification MCP

Ein MCP-Server zum Senden von Fortschritts- und manuellen Genehmigungs-E-Mails über SMTP. Er verwendet den standardmäßigen stdio-Transport und eignet sich für den Aufruf durch MCP-Clients wie Codex, Claude Desktop, Cursor, VS Code usw.

Bereitgestellte Tools

• send_progress_update: Sendet Projektfortschritts-, Abschluss- oder Blockiert-Meldungen.

• request_human_approval: Sendet Angelegenheiten, die manuell genehmigt/abgelehnt werden müssen, und generiert eine Genehmigungsnummer.

• send_simple_email: Sendet normale Klartext- oder HTML-E-Mails.

• send_custom_email: Sendet benutzerdefinierte E-Mails mit CC/BCC und Anhängen.

• test_smtp_connection: Testet SMTP-Verbindung und -Authentifizierung.

• test_imap_connection: Testet IMAP-Verbindung und -Authentifizierung.

• read_replies: Liest die neuesten Antworten im Posteingang, standardmäßig ohne als gelesen zu markieren.

• check_approval_status: Erkennt „Genehmigt“, „Abgelehnt“ oder „Ausstehend“ anhand der Genehmigungsnummer.

• wait_for_approval: Pollt und wartet auf eine manuelle Antwort, bis Genehmigung, Ablehnung oder Timeout eintritt.

Die Standardempfänger für Fortschrittstools stammen aus config.json; Genehmigungs-E-Mails fordern ausdrücklich eine Antwort mit „Genehmigt“ oder „Abgelehnt“. Andere Projektingenieure müssen lediglich die MCP-Tools aufrufen und müssen SMTP nicht selbst implementieren.

Related MCP server: mcp-email-server

1. Konfiguration von SMTP und Ziel-E-Mail-Adresse

Bearbeiten Sie die config.json im Projektstammverzeichnis (Vorlage siehe 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": "我的工程"
  }
}

Es wird empfohlen, das Passwort in einer Umgebungsvariable zu platzieren, anstatt es direkt in die Datei zu schreiben:

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

Sie können auch direkt smtp.password ausfüllen. Die config.json wird von .gitignore ignoriert und sollte nicht in das Versionsverwaltungs-Repository eingecheckt werden.

Häufige SMTP-Einstellungen:

Gmail, QQ usw. erfordern normalerweise, dass SMTP aktiviert ist und ein anwendungsspezifisches Passwort verwendet wird. Wenn das normale Web-Login-Passwort nicht direkt verwendet werden kann, erstellen Sie gemäß den Anforderungen des E-Mail-Anbieters einen Autorisierungscode/App-Passcode.

IMAP wird zum Lesen von Antworten verwendet. QQ Mail verwendet normalerweise imap.qq.com:993 + SSL; wenn imap.password weggelassen wird, verwendet das Programm das SMTP-Passwort/zugriffs-Code. Umgebungsvariablen überschreiben config.json; es können auch IMAP_HOST, IMAP_PORT, IMAP_SECURE, IMAP_USER, IMAP_PASS und NOTIFY_TO verwendet werden.

2. Installation und Test

Erfordert Python 3.11+ und uv. Führen Sie in PowerShell aus:

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

Im stdio-Modus von MCP sollte kein normaler Text manuell eingegeben werden; der MCP-Client startet den Prozess. Es wird empfohlen, zuerst test_smtp_connection und test_imap_connection aufzurufen.

3. Einbindung in andere Projekte

Am Beispiel eines Clients, der das mcpServers-Format unterstützt, fügen Sie die folgenden Servereinträge in die Client-Konfiguration ein. Windows-Pfade müssen doppelte Backslashes verwenden:

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

Wenn uv nicht im PATH des Clients liegt, ersetzen Sie den command durch den absoluten Pfad der uv.exe. Starten Sie den Client nach der Änderung der MCP-Konfiguration neu.

Aufrufbeispiele

Statusbericht senden verwenden Zeitabläufe:

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

Manuelle Aktion:

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

Das Tool unterstützt einen optionalen to-Parameter, um den Empfänger für einen einzelnen Vorgang zu überschreiben; wenn er weggelassen wird, verwendet es notification.to aus config.json.

Antworten lesen:

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

Genehmigung bestätigen:

调用 check_approval_status：
approval_id="APR-ABC1234567"

Der von den Genehmigungstools zurückgegebene Status ist approved, rejected, pending oder timeout. Standardmäßig wird nur der INBOX gelesen und der Gelesen-Status von E-Mails wird nicht automatisch geändert.

Sicherheitshinweise

• Verwenden Sie bevorzugt anwendungsspezifische Passwörter oder Autorisierungscodes, nicht das Haupt-E-Mail-Passwort.

• Committen Sie keine echten Passwörter oder echte Ziel-E-Mail-Adressen in Git.

• Standardmäßig wird lokales stdio verwendet; der HTTP-Modus bindet nur 127.0.0.1.