ai-mail-mcp

Binde private Domain-E-Mail-Postfächer in jeden MCP-Client ein. Unterstützt Senden (mit automatischer persönlicher Signatur / Link zur Markenvorstellungsseite), Empfangen, Lesen von E-Mail-Inhalten und Verbindungstest.

Kompatibel mit WorkBuddy, Claude Desktop, Cursor und allen anderen Tools, die das MCP-Protokoll unterstützen. Durch Cloud-Bereitstellung können WorkBuddy-PC und mobile Endgeräte denselben E-Mail-Eingang nutzen, um jederzeit und überall mit natürlicher Sprache E-Mail-Aufgaben zu erledigen.

Eigenschaften

• ✉️ send_email: E-Mail senden, automatisch persönliche Signatur „Gesendet von xx über xx“ (mit Link zur Vorstellungsseite, kann als persönlicher IP-Einstieg genutzt werden) anhängen

• 📥 get_recent_emails: Liste der E-Mails der letzten N Tage abrufen (Betreff / Absender / Zeit)

• 📖 get_email_content: Vollständigen E-Mail-Text und Anhangsinformationen nach UID lesen

• 🔌 test_email_connection: SMTP/IMAP-Verbindung mit einem Klick testen

• 🚀 Zwei Übertragungsarten: stdio (lokales Debuggen) / SSE (Cloud-Fernbereitstellung)

• 🔐 Endpunkt-Bearer-Token-Authentifizierung, alle Zugangsdaten über Umgebungsvariablen, niemals hartcodiert

Architektur

┌──────────────┐   HTTPS + Bearer   ┌──────────────────┐   SMTP/IMAP   ┌──────────────┐
│ WorkBuddy    │ ─────────────────▶ │ ai-mail-mcp      │ ────────────▶ │ 你的域名邮箱   │
│ 桌面端 / 移动端 │                   │ (云端 MCP Server) │               │ you@your.com │
└──────────────┘                   └──────────────────┘               └──────────────┘

Cloud-Bereitstellung ist entscheidend: Ein HTTPS-Endpunkt, den sowohl Desktop als auch Mobile erreichen können, der lokale Rechner muss nicht eingeschaltet sein.

Schnellstart

1. Umgebungsvariablen konfigurieren

cp .env.example .env
# 编辑 .env，填入你的邮箱账号、授权码、SMTP/IMAP 地址、Bearer Token

2A. Lokales Debuggen (stdio)

npm install
MCP_TRANSPORT=stdio node server.js

2B. Cloud-Bereitstellung (SSE, empfohlen)

Erfordert einen Server mit öffentlicher IP + einer Domain (HTTPS).

cp .env.example .env   # 在服务器上填写真实配置
docker compose up -d

Dann nginx als Reverse-Proxy + acme.sh/certbot für HTTPS-Zertifikate (es gibt Kommentare in docker-compose.yml), um einen Endpunkt wie https://mcp.your-domain.com/mail-mcp/sse zu erhalten.

3. In WorkBuddy einbinden (benutzerdefinierter Connector)

Bearbeite ~/.workbuddy/mcp.json:

{
  "mcpServers": {
    "ai-mail-mcp": {
      "type": "sse",
      "url": "https://mcp.your-domain.com/mail-mcp/sse",
      "headers": {
        "Authorization": "Bearer 你的随机Token"
      }
    }
  }
}

Klicke in der WorkBuddy-Connector-Verwaltung auf Trust / Aktiviere den Connector und starte die Sitzung neu. Dann kannst du im Chat:

• „Sende eine E-Mail an xx, Betreff …, Text …“

• „Zeige mir meine E-Mails der letzten 3 Tage und fasse zusammen, welche beantwortet werden müssen“

• „Sende mir jeden Morgen um 9 Uhr die Zusammenfassung der gestrigen E-Mails“

Werkzeugliste

Sicherheitshinweise

• MCP_BEARER_TOKEN muss auf einen ausreichend zufälligen langen String gesetzt werden (mit openssl rand -hex 32 generieren) und muss sicher verwahrt werden

• .env und echte Zugangsdaten niemals in ein Repository einchecken; dieses Repository enthält nur .env.example

• Für die E-Mail-Adresse wird ein separates Konto mit minimalen Berechtigungen empfohlen (nur Senden/Empfangen, kein Löschen/Verwalten)

• Selbsthosting bedeutet, dass die E-Mail-Daten vollständig auf dem eigenen Server bleiben und nicht an Dritte weitergegeben werden

Lizenz

MIT