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 服务器。