Exchange EWS MCP v0.9.0

English | 简体中文

📮 オンプレミスの Exchange に AI アシスタントを。

先週のレポートをコピーするのにうんざりしていませんか？返信のたびに古いメールを探し回っていませんか？ミーティングを予約するために、一人ひとりのカレンダーを確認していませんか？

Exchange EWS MCP は、EWS + NTLM を介して MCP エージェントを Microsoft Exchange に接続します。エージェントはメールの検索、下書きの作成、週次レポートの更新、空き時間の確認、会議の管理を実行できます。重要な送信はユーザーの管理下に残ります。

[!IMPORTANT] EWS + NTLM を使用するオンプレミス Exchange 向けに設計されています。Exchange Online / Microsoft Graph OAuth クライアントではありません。

✨ ハイライト

• 📧 メールの検索、下書きの作成、返信、転送、下書きの編集、添付ファイルの追加。

• 👥 完全なピンイン名または完全なメールアドレスから受信者を解決します。

• 📝 他の人の週次レポートメールから合成されたレポートを含め、元の Outlook HTML レイアウトを維持しながら週次レポートを更新します。

• 📅 空き時間の確認、共通時間の検索、会議の作成/編集、確認後の招待状の送信。

• 🔐 パスワードを Windows Credential Manager に保存します。

• 🛡️ 下書き優先のワークフローにより、最終送信はユーザーの管理下に残ります。

Related MCP server: OWA Exchange MCP Server

🧭 アーキテクチャ

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"]

サーバーは Windows 上でローカルに実行され、より高レベルなメールおよびカレンダーのワークフローをエージェントに公開します。Exchange の資格情報と低レベルの Exchange ID はサーバー側に保持されます。

🚀 クイックスタート

クローン → インストール → Exchange に接続 → MCP クライアントに 1 つのサーバーパスを貼り付け。

1. 要件

• Windows 10/11 または Windows Server

• Python 3.10–3.13

• Exchange EWS エンドポイントへのアクセス

• EWS を NTLM で使用できる Exchange アカウント

2. インストール

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

インストーラーは .venv を作成し、すべてをローカルにインストールします。

3. Exchange の構成

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

現在のメールボックスユーザーを設定します：

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

接続を確認します：

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

パスワードはWindows Credential Managerに保存され、リポジトリには保存されません。

4. カレンダーの設定

.\.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 クライアントを接続する

✅ 推奨：EXE を直接指定する

インストール後、本番 MCP サーバーは次のとおりです：

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

MCP クライアントにコマンドフィールドと引数フィールドがある場合：

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

Arguments:
<leave empty>

絶対パスを使用し、構成を保存して、MCP クライアントを再起動します。

または JSON を使用

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

次のように実行することもできます：

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

6. 検証

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

期待されるバージョン: 0.9.0 · 本番ツール: 11

🎉 完了 — エージェントは Exchange で作業できるようになりました。

💬 これらのプロンプトを試す

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.

🧰 主な機能

コンパクトなメールファサードは、search_mail、read_mail、resolve_people、save_mail_draft、edit_mail_draft を使用します。週次レポートは、weekly_report という単一のエントリとそれに続く continue_action を使用します。HTML は常にサーバー側で保持されます。カレンダーの作成/編集は save_meeting を使用し、確認後の送信は send_meeting_invitation を使用します。

📝 週次レポート

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

集約プロンプトの場合、エージェントはまずソースレポートを検索/読み取りして要約します。その要約が weekly_report に渡される request になります。ツール自体は他のユーザーのメールを検索しません。

エージェントは HTML テンプレート全体を再生成しません。サーバーは既存のレイアウトを維持し、承認されたテキストスロットのみを更新します。エージェントは合計 3 週間分のコンテキスト（現在編集可能なレポートと過去 2 回のレポート）を受け取り、s1 のような短いローカルスロット ID を使用します。また、サーバーは次回の下書き用に、対応する件名の日付/週のマーカーを自動的に進めます。

🔒 安全性の要点

• メールは下書き優先です。

• 会議の送信には明示的な確認が必要です。

• 資格情報は Windows Credential Manager に保持されます。

• 曖昧な受信者や会議時間は推測せず、確認のために返されます。

📚 ドキュメント

エージェント接続 · エージェントツール · アーキテクチャ · 週次レポート · 開発テスト · 変更ログ

貢献者の方へ: CONTRIBUTING.md · SECURITY.md

制限事項

Windows が主な実行対象環境です。EWS の動作は Exchange のバージョンとメールボックスのポリシーによって異なります。週次レポートの編集は、現在、サポートされている Outlook/Word HTML 返信構造を前提としています。Exchange Online ユーザーは、通常、Microsoft Graph とモダン認証を使用することをお勧めします。

ライセンス

MIT License の下で公開されています。