Owa Exchange MCP

🚀 OWA Exchange MCP 服務器

OWA Exchange MCP 服務器是一個適用於任何 Microsoft Exchange / OWA（Outlook Web Access）部署的 MCP（模型上下文協議）服務器。它通過 30 個工具，讓大語言模型（LLM）代理能夠訪問電子郵件、日曆、目錄搜索、文件夾、可用性和會議分析等功能。該服務器可與任何暴露 OWA 的本地或託管 Exchange 服務器配合使用。

🚀 快速開始

# 複製並使用你的 OWA URL 編輯 MCP 配置
cp .mcp.json.example .mcp.json

# 一次性操作：設置加密憑證
python3 login.py --setup

# 登錄（打開無頭瀏覽器，需要進行 2FA 驗證）
python3 login.py

# 安裝 MCP 服務器
pip install -e .

📦 安裝指南

將其添加到你的 MCP 客戶端配置中。將 https://owa.example.com 替換為你的 OWA URL。

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "exchange": {
      "command": "uvx",
      "args": ["exchange-mcp-server"],
      "env": {
        "EXCHANGE_OWA_URL": "https://owa.example.com"
      }
    }
  }
}

Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "exchange": {
      "command": "uvx",
      "args": ["exchange-mcp-server"],
      "env": {
        "EXCHANGE_OWA_URL": "https://owa.example.com"
      }
    }
  }
}

Claude Code（.mcp.json）：

{
  "mcpServers": {
    "exchange": {
      "command": "uvx",
      "args": ["exchange-mcp-server"],
      "env": {
        "EXCHANGE_OWA_URL": "https://owa.example.com"
      }
    }
  }
}

📚 詳細文檔

配置

登錄

選項 A：通過 MCP 工具（推薦）

login 工具可在 MCP 會話中處理憑證設置和身份驗證，無需單獨的終端。

首次使用（設置 + 登錄）：

login(master_password="...", username="user@example.com", password="...")

後續登錄（解密存儲的憑證）：

login(master_password="...")

選項 B：通過命令行界面（CLI）

python3 login.py --setup   # 首次使用：保存加密憑證
python3 login.py            # 使用 2FA 登錄

兩種方法的操作步驟如下：

1. 打開一個無頭瀏覽器，訪問你的 OWA URL。
2. 提交憑證。
3. 等待 2FA 批准（最長 90 秒）。
4. 將加密的會話 cookie 保存到 session-cookies.txt。

憑證和會話 cookie 在靜態存儲時使用 AES - 256（PBKDF2 密鑰推導，480k 迭代）進行加密。

工具（30 個）

電子郵件（10 個）

日曆（7 個）

目錄（1 個）

文件夾（7 個）

可用性（2 個）

分析（2 個）

身份驗證（1 個）

文件結構

login.py                  # 基於瀏覽器的 2FA 登錄（獨立 CLI）
exchange_mcp/
  server.py               # FastMCP 服務器入口點
  owa_client.py           # OWA HTTP 客戶端
  auth.py                 # 異步登錄邏輯（MCP 工具共享）
  tools/
    email.py              # 電子郵件工具
    calendar.py           # 日曆工具
    people.py             # 目錄搜索
    folders.py            # 文件夾管理和會話檢查
    availability.py       # 空閒時間/會議時間
    analytics.py          # 會議統計和聯繫人
    auth.py               # 登錄工具
pyproject.toml            # 包配置

⚠️ 重要提示

每個 Exchange / OWA 部署都有自己的身份驗證設置 — 有些需要 2FA（推送通知、TOTP、SMS），而其他的則使用單因素登錄或 SSO。本項目中的登錄邏輯（login.py 和 exchange_mcp/auth.py）是為特定的 2FA 流程（移動推送批准）編寫的。如果你的 OWA 服務器使用不同的 2FA 方法或根本不使用 2FA，你需要修改或刪除登錄邏輯以適應你的環境。

🔒 安全說明

• 憑證和會話 cookie 使用 AES - 256 - Fernet 加密。
• 主密碼從不存儲。
• 使用 PBKDF2 進行 480,000 次迭代的密鑰推導。
• 憑證和 cookie 文件的權限為 0600。
• 僅在內存中解密 cookie，從不以明文形式寫入磁盤（通過 MCP 工具）。
• 會話 cookie 僅傳輸到你的 OWA 服務器。