send_issue_email MCP

Sendet die Kontakt-E-Mail und Problembeschreibung, die der Benutzer bei der Übergabe an einen menschlichen Agenten hinterlassen hat, per SMTP an ein festes Service-Postfach.

Der Agent sieht nur ein Tool: send_issue_email(email, question).

Welche drei E-Mail-Adressen gibt es?

.env ist die Infrastruktur und wird einmal bereitgestellt. email / question unterscheiden sich bei jedem Gespräch und werden vom Agenten aus Gesprächsvariablen (z. B. $邮箱, $问题) übergeben.

Related MCP server: MCP Sendmail Server

Systemanforderungen

• Python 3.10+

• Zugriff auf den verwendeten SMTP-Server (bei direktem Gmail-Zugriff vom Rechner sind ausgehende Verbindungen auf 465/587 erforderlich)

Installation

cd send_issue_email_mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env

Fülle .env gemäß den folgenden Anweisungen aus und committe .env nicht in das Repository.

.env konfigurieren

Pflichtfelder: Empfang und SMTP

TARGET_EMAIL=issues@example.com

SMTP_HOST=smtp.gmail.com
SMTP_PORT=465
SMTP_USERNAME=your_account@gmail.com
SMTP_PASSWORD=xxxx xxxx xxxx xxxx
SMTP_USE_SSL=true

SENDER_EMAIL=your_account@gmail.com
SENDER_NAME=问题收集机器人

Zwei äquivalente Kombinationen für Gmail:

Bei Workspace-/Schul-Google-Konten kann SMTP vom Administrator deaktiviert sein; in diesem Fall ist keine Verbindung möglich.

MCP-Transport (Remote-Clients)

智齿 sendet einen POST / an die von dir angegebene URL-Wurzel. Daher gilt für Remote standardmäßig Folgendes:

MCP_TRANSPORT=streamable-http
MCP_HOST=0.0.0.0
MCP_PORT=8765
MCP_PATH=/

Wenn nach dem Ändern von .env im Terminal bereits gleichnamige Variablen per export gesetzt wurden, überschreibt load_dotenv() diese nicht. Öffne ein neues Terminal oder führe zuerst unset MCP_TRANSPORT TARGET_EMAIL aus, bevor du startest.

Zuerst den Versand testen (ohne MCP zu starten)

source .venv/bin/activate
python test_email.py

Bei Erfolg wird ausgegeben: 成功：问题已发送至服务邮箱 ...

Das erste Argument im Skript ist die simulierte Benutzer-Kontakt-E-Mail, nicht der Absender. Es wird empfohlen, sie für den Test durch deine eigene echte E-Mail zu ersetzen, um zu vermeiden, dass example.com vom Empfänger in den Spam-Ordner verschoben wird.

SMTP-Erfolg bedeutet nur, dass das Postamt die Nachricht angenommen hat. Wenn das Ziel z. B. ein Feishu-Unternehmenspostfach ist, prüfe zusätzlich den Ordner „Gesendet" des Absenders, auf Unzustellbarkeitsmeldungen und den Spam-/Quarantäne-Ordner des Empfängers.

MCP starten (智齿 / Remote)

source .venv/bin/activate
python server.py

Im Log sollte Ähnliches erscheinen:

transport 'streamable-http' (stateless) on http://0.0.0.0:8765/

Starte nicht zwei Instanzen gleichzeitig, sonst kommt address already in use. Stoppe vor einem Neustart zuerst den alten Prozess.

URL, die in 智齿 eingetragen wird

Wähle als Übertragungstyp Streamable HTTP / HTTP (nicht SSE).

Die URL darf kein /sse oder /mcp enthalten. Trage die Wurzel-Adresse ein, die diese Maschine erreicht:

http://<这台机器的可达地址>:<MCP_PORT>/

Z. B. im LAN: http://192.168.x.x:8765/

Wenn 智齿 eine Cloud-SaaS-Lösung ist, kann die interne IP nicht erreicht werden. Es wird eine öffentliche IP, eine Domain oder ein Tunnel benötigt. Die URL ist ebenfalls die Wurzel, ohne Suffix.

Nach dem Speichern erneut verbinden. Im Service-Log sollte POST / HTTP/1.1" 200 stehen, nicht 404.

Lokaler Selbsttest

curl -sS -X POST http://127.0.0.1:8765/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"check","version":"0.0.1"}}}'

Bei Erfolg wird ein JSON mit "jsonrpc":"2.0" und "serverInfo":{"name":"issue-collector"...} zurückgegeben.

MCP starten (lokales stdio)

Nachdem in .env MCP_TRANSPORT=stdio gesetzt wurde, wird der Prozess von einem lokalen Client wie Cursor per Befehl gestartet, z. B.:

{
  "mcpServers": {
    "issue-collector": {
      "command": "/绝对路径/send_issue_email_mcp/.venv/bin/python",
      "args": ["/绝对路径/send_issue_email_mcp/server.py"]
    }
  }
}

Im stdio-Modus dürfen normale Logs nicht auf stdout ausgegeben werden.

Tool-Konventionen

send_issue_email(email: str, question: str) -> str

• email: Kontakt-E-Mail des Benutzers

• question: Problem/Anliegen

• Gibt eine Zeichenkette zurück, die mit 成功： oder 错误： beginnt, damit der Agent verzweigen kann

E-Mail-Betreff: [问题收集] 来自用户 {email} ({时间})
Der Text enthält die Benutzer-E-Mail, den Zeitpunkt der Übermittlung und die Problembeschreibung; Reply-To ist die Benutzer-E-Mail.

Nach erfolgreichem send_message wird das MCP-Ergebnis sofort zurückgegeben. SMTP QUIT/Verbindungsschluss erfolgt in einem Hintergrund-Thread, um zu vermeiden, dass das Schließen von SSL das 智齿-Timeout überschreitet.

Logs

Ausführungslogs werden unter log/ im Projektverzeichnis geschrieben, eine Datei pro Tag. Bei mehreren Starts am selben Tag wird angehängt:

log/2026-08-19.log

Enthält Beginn/Ende von HTTP-Anfragen, Tool-Aufrufe, SMTP-Verbindungs-/Anmelde-/Sendezeiten und das Ergebnis des Hintergrund-Schließens. Kein SMTP-Passwort.

Fehlerbehebung

load_dotenv() wird beim Start von server.py einmal ausgeführt. Wenn nur .env geändert wird, ohne den Prozess neu zu starten, liest der laufende Dienst die neuen Werte nicht.