Exchange EWS MCP v0.9.0

English | 简体中文

📮 Geben Sie Ihrem On-Premises-Exchange einen KI-Assistenten.

Haben Sie es satt, den Bericht der letzten Woche zu kopieren? Vor jeder Antwort in alten E-Mails zu wühlen? Kalender einzeln durchzugehen, nur um einen Termin zu vereinbaren?

Exchange EWS MCP verbindet einen MCP-Agenten über EWS + NTLM mit Microsoft Exchange. Der Agent kann E-Mails durchsuchen, Entwürfe vorbereiten, Wochenberichte aktualisieren, Verfügbarkeiten prüfen und Besprechungen verwalten – während der endgültige Versand unter der Kontrolle des Benutzers bleibt.

[!IMPORTANT] Entwickelt für On-Premises-Exchange mit EWS + NTLM. Es ist kein Exchange-Online- oder Microsoft-Graph-OAuth-Client.

✨ Highlights

• 📧 E-Mails suchen, Antworten, Entwürfe erstellen, weiterleiten, Entwürfe bearbeiten, Anhänge hinzufügen.

• 👥 Empfänger anhand vollständiger Pinyin-Namen oder vollständiger E-Mail-Adressen defaulten.

• 📝 Wochenberichte aktualisieren – einschließlich Berichten, die aus den Wochenbericht-E-Mails anderer Personen zusammengestellt –, ohne das ursprüngliche Outlook-HTML-Layout zu zerstören.

• 📅 Verfügbarkeit prüfen, gemeinsame Zeitfenster finden, Besprechungen erstellen/bearbeiten und nach Bestätigung Einladungen senden.

• 🔐 Passwörter im Windows-Credential-Manager speichern.

• 🛡️ Entwurf-zuerst-Workflows: Der finale Versand bleibt unter Benutzerkontrolle.

Related MCP server: OWA Exchange MCP Server

🧭 Architektur

flowchart LR
    A["MCP client / Agent"] -->|stdio| S["Exchange EWS MCP"]
    S --> M["Semantic mail workflows"]
    S --> W["Weekly-report workflow"]
    S --> C["Calendar coordination"]
    M --> E["EWS client + NTLM"]
    W --> E
    C --> E
    E --> X["On-premises Exchange"]
    M --> R["Local reference store"]
    W --> R
    C --> R
    S --> K["Windows Credential Manager"]

Der Server läuft lokal auf Windows und macht dem Digital Agent höherwertige Mail-/Kalender-Workflows zugänglich. Die Exchange-Zugangsdaten und Low-level-Exchange-IDs bleiben auf Dem Server.

🚀 Schnellstart

Klonen → installieren → Exchange anschließen → einen Serverpfad in Ihren MCP-Client einfügen.

1. Voraussetzungen

• Windows 10/11 ode-Windows-Server

• Python 3.10–3.13

• Zugriff auf Ihren Exchange-EWS-Endpunkt

• Ein Exchange-Konto, das EWS mit NTLM nutzen darf

2. Installation

git clone https://github.com/ShermanGu/exchange-ews-mcp.git
cd exchange-ews-mcp
.\install.cmd

Das Installationsprogramm erstellt .venv und installiert alles lokal.

3. Exchange einrichten

.\.venv\Scripts\exchange-ews-mcp.exe configure

Aktuellen Postfachbenutzer festlegen:

.\.venv\Scripts\exchange-ews-mcp.exe set-current-user `
  --email "you@company.example" `
  --display-name "Your Name"

Verbindung testen:

.\.venv\Scripts\exchange-ews-mcp.exe status
.\.venv\Scripts\exchange-ews-mcp.exe test

Ihr Passwort ist im Windows-Credential-Manager gespeichert, nicht im Repository.

4. Kalendereinstellungen festlegen

.\.venv\Scripts\exchange-ews-mcp.exe set-calendar-preferences `
  --time-zone "Asia/Shanghai" `
  --workday-start "09:00" `
  --workday-end "18:00" `
  --slot-minutes 30

5. MCP-Client verbinden

✅ Empfohlen: Direkt auf die EXE zeigen

Nach der Installation ist der Produktions-MCP-Server:

<repo>\.venv\Scripts\exchange-ews-mcp-server.exe

Falls Ihr MCP-Client Command- und Arguments-Felder besitzt:

Command:
D:\tools\exchange-ews-mcp\.venv\Scripts\exchange-ews-mcp-server.exe

Arguments:
<leave empty>

Verwenden Sie einen absoluten Pfad, speichern Sie die Konfiguration und starten Sie den MCP-Client neu.

OOB AutoCAD "Odbrukt"

Oder per JSON

{
  "mcpServers": {
    "exchange-ews": {
      "command": "D:\\tools\\exchange-ews-mcp\\.venv\\Scripts\\exchange-ews-mcp-server.exe"
    }
  }
}

Sie können auch so starten/aufrufen:

.\.venv\Scripts\exchange-ews-mcp.exe mcp-config

6. Verifizieren

.\.venv\Scripts\exchange-ews-mcp.exe version
.\.venv\Scripts\exchange-ews-mcp.exe tool-list

Erwartet werden: Version 0.9.0 · Produktions-Tools: 11

🎉 Fertig – Ihr Agent kann jetzt über Exchange arbeiten.

💬 Probieren Sie doch mal folgende Prompts aus

Find my latest weekly report and update it with this week's progress.

Summarize the weekly reports A and B sent me, then use that summary to generate my new weekly-report draft.

Draft an email to wangxiaoming saying integration testing is complete. Don't send it.

Find the earliest one-hour slot next week when lixiaohong and I are both free, create a meeting, and save it without sending.

🧰 Hauptleistungsübersicht

Die kompakte E-Mail-Fassade verwendet search_mail, read_mail, resolve_people, save_mail_draft und edit_mail_draft. Wochenberichte nutzen den kurzen Einstieg weekly_report – gefolgt von continue_action; das HTML bleibt immer server-seitig. Beim Kalender wird save_meeting verwendet, das Versenden bestätigter Einladungen erfolgt über send_meeting_invitation.

📝 Wochenberichte

Direct user update ───────────────┐
                                   ├→ weekly_report(request=...)
search_mail/read_mail → LLM summary ┘
                                   ↓
                         Read recent history + slots
                                   ↓
                         Agent routes request by loc
                                   ↓
                         Update only relevant text
                                   ↓
                  Create an unsent Reply All or Compose draft

Bei Aggregations-Prompts sucht/liest die Agent zunächst die Quell-Berichte und fasst sie zusammen; diese Zusammenfassung wird dann als request an weekly_report übergeben. Das Tool selbst durchsucht keine Postfächer anderer Benutzer.

Der Agent regeneriert die HTML-Vorlage nicht. Der Server bleibt der Layout-Halter und aktualisiert nur genehmigte Text-Slots. Der Agent erhält drei Wochen Kontext (den aktuell bearbeiteten Bericht plus zwei Wochen vorher) heraus und bekommt und e Kürzel wie s1 – der Server verschiebt die unterstützten Datums-/Wochenmarker im Betreff automatisch auf den nächsten Entwurf.

🔒 Sicherheit in Kurzform

• E-Mails laufen immer zuerst als Entwurf (draft-first).

• Der Versand von Umtauschen erbeten ausdrücklich eine Freigabe (Bestätigung).

• Nachweislich bleiben Anmeldedaten im Windows-Credential-Manager.

• Unklare Empfänger oder Terminlagen werden nicht geraten, sondern zur Bestätigung zurückgegeben.

📚 Dokumentation

Agent-Verbindung · Agent-Tools · Architektur · Wochenbericht · Dev-Tests · Changelog

Übrigens: CONTRIBUTING.md · SECURITY.md

Einschränkungen

Hauptzielplattform ist Windows. Das Verhalten von EWS hängt von der Integrations-/Exchange-Version und der Mailbox-Richtlinie ab. Die Bearbeitung des Wochenbericht setzt einen Outlook-Client mit passendem Word-HTML baar voraus. Online-Server, z.B. Exchange Online, sollten besser über Microsoft Graph / erste Modern auth laufen.

Lizenz

Veröffentlicht unter der MIT-Lizenz.