Exchange EWS MCP v0.9.0

영어 | 简体中文

📮 온-프레미스 Exchange에 AI 어시스턴트를 제공하세요.

지난주 보고서를 복사하는 데 지치셨나요? 모든 답장 전에 오래된 메일을 뒤지는 데 지치셨나요? 회의를 잡기 위해 한 명씩 일정을 확인하는 데 지치셨나요?

Exchange EWS MCP는 EWS + NTLM을 통해 MCP 에이전트를 Microsoft Exchange에 연결합니다. 에이전트는 메일 검색, 초안 작성, 주간 보고서 업데이트, 가용성 확인, 회의 관리 등을 수행할 수 있으며, 중요한 발송은 사용자 통제 하에 유지됩니다.

[!IMPORTANT] EWS + NTLM을 사용하는 온-프레미스 Exchange용으로 설계되었습니다. Exchange Online / Microsoft Graph OAuth 클라이언트가 아닙니다.

✨ 주요 기능

• 📧 메일 검색, 초안 작성, 답장, 전달, 초안 편집, 첨부 파일 추가.

• 👥 전체 병음 이름 또는 완전한 이메일 주소로 수신자 확인.

• 📝 원래 Outlook HTML 레이아웃을 유지하면서 주간 보고서 업데이트(다른 사람의 주간 보고서 이메일에서 종합한 보고서 포함).

• 📅 가용성 확인, 공통 시간 찾기, 회의 생성/편집, 확인 후 초대장 발송.

• 🔐 Windows 자격 증명 관리자에 비밀번호 저장.

• 🛡️ 초안 우선 워크플로로 최종 발송은 사용자 통제 하에 유지.

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. 요구 사항

• Windows 10/11 또는 Windows Server

• Python 3.10–3.13

• Exchange EWS 엔드포인트에 대한 액세스

• NTLM으로 EWS 사용이 허용된 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 자격 증명 관리자에 저장되며, 저장소에 저장되지 않습니다.

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주 분량의 컨텍스트(현재 편집 가능한 보고서 + 이전 두 보고서)를 받고, s1과 같은 짧은 로컬 슬롯 ID를 사용하며, 서버는 다음 초안을 위해 지원되는 제목 날짜/주 표시를 자동으로 진행합니다.

🔒 안전 요약

• 메일은 초안 우선입니다.

• 회의 발송은 명시적 확인이 필요합니다.

• 자격 증명은 Windows 자격 증명 관리자에 유지됩니다.

• 모호한 수신자나 회의 시간은 추측하지 않고 확인을 위해 반환됩니다.

📚 문서

에이전트 연결 · 에이전트 도구 · 아키텍처 · 주간 보고서 · 개발 테스트 · 변경 로그

기여자용: CONTRIBUTING.md · SECURITY.md

제한 사항

Windows가 기본 런타임 대상입니다. EWS 동작은 Exchange 버전 및 사서함 정책에 따라 달라집니다. 주간 보고서 편집은 현재 지원되는 Outlook/Word HTML 답장 구조를 기대합니다. Exchange Online 사용자는 일반적으로 Microsoft Graph 및 최신 인증을 선호해야 합니다.

라이선스

MIT 라이선스에 따라 배포됩니다.