Outlook MCP

🚀 Outlook MCP Server

Outlook MCP Server 是一個模型上下文協議（MCP）服務器，它藉助 Microsoft Graph API 讓 Claude 能夠訪問 Microsoft Outlook。該服務器支持多賬戶管理，具備遠程部署能力，可全面管理郵件、日曆和文件夾。

🚀 快速開始

1. 安裝依賴

npm install

2. 配置 Azure 應用註冊

1. 在 Azure 門戶 創建一個 Azure 應用註冊。
2. 設置重定向 URI：
   • http://localhost:3333/auth/callback
   • 對於遠程部署：https://your-domain.com/auth/callback
3. 授予權限：Mail.ReadWrite、Calendars.ReadWrite、offline_access

3. 環境配置

將 .env.example 複製為 .env 並進行配置：

# Azure 應用註冊
MS_CLIENT_ID=your-azure-client-id
MS_CLIENT_SECRET=your-azure-client-secret
OUTLOOK_CLIENT_ID=your-azure-client-id
OUTLOOK_CLIENT_SECRET=your-azure-client-secret

# 服務器配置
USE_TEST_MODE=false
MCP_PORT=3001

4. Claude 桌面端配置

在你的 Claude 桌面端配置中添加以下內容：

{
  "mcpServers": {
    "outlook-mcp": {
      "command": "node",
      "args": ["/path/to/outlook-mcp/index.js"],
      "env": {
        "USE_TEST_MODE": "false"
      }
    }
  }
}

✨ 主要特性

多賬戶支持

• 可同時管理多個 Outlook 賬戶。
• 每個賬戶有獨立的身份驗證和令牌存儲。
• 支持特定賬戶的操作和數據隔離。

郵件管理

• 列出、搜索和閱讀郵件。
• 發送郵件和創建草稿。
• 回覆郵件。
• 管理文件夾並移動郵件。
• 處理附件。

日曆管理

• 列出日曆事件。
• 創建、更新和刪除事件。
• 接受/拒絕會議邀請。
• 管理日曆權限。

文件夾和規則管理

• 創建和管理郵件文件夾。
• 設置郵件規則和過濾器。
• 組織郵箱結構。

💻 使用示例

基礎用法

本地模式（默認）

npm start

通過標準輸入輸出與 Claude 桌面端集成運行。

遠程模式

npm run start-remote

在端口 3001 上運行 HTTP 服務器，MCP 端點為 /mcp。

測試模式

npm run test-mode

使用模擬數據進行開發。

📚 詳細文檔

MCP 工具

身份驗證

• authenticate - 添加新的 Outlook 賬戶
• check-auth-status - 查看賬戶身份驗證狀態
• list-accounts - 列出所有已配置的賬戶
• remove-account - 刪除一個賬戶

郵件工具

• list-emails - 列出帶有過濾選項的郵件
• read-email - 閱讀特定郵件內容
• send-email - 發送新郵件
• create-draft - 創建郵件草稿
• reply-to-email - 回覆現有郵件
• search-emails - 根據條件搜索郵件
• mark-as-read - 將郵件標記為已讀/未讀

日曆工具

• list-calendar-events - 列出日曆事件
• create-calendar-event - 創建新事件
• delete-calendar-event - 刪除事件
• accept-calendar-event - 接受會議邀請
• decline-calendar-event - 拒絕會議邀請

文件夾工具

• list-folders - 列出郵件文件夾
• create-folder - 創建新文件夾
• move-email - 將郵件移動到文件夾

部署

Railway 部署

1. 將你的 GitHub 倉庫連接到 Railway。
2. 在 Railway 控制檯設置環境變量。
3. 在代碼推送時自動部署。

Railway 的環境變量：

MS_CLIENT_ID=your-azure-client-id
MS_CLIENT_SECRET=your-azure-client-secret
OUTLOOK_CLIENT_ID=your-azure-client-id
OUTLOOK_CLIENT_SECRET=your-azure-client-secret
NODE_ENV=production
USE_TEST_MODE=false

Docker 部署

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --production
COPY . .
EXPOSE 3001
CMD ["npm", "run", "start-remote"]

手動服務器設置

1. 克隆倉庫。
2. 安裝依賴：npm ci --production。
3. 配置環境變量。
4. 啟動服務器：npm run start-remote。
5. 如有需要，配置反向代理（nginx/Apache）。

架構

outlook-mcp/
├── auth/                  # 身份驗證和賬戶管理
│   ├── index.js          # 主要身份驗證模塊導出
│   ├── server.js         # OAuth 服務器（從根目錄移動）
│   ├── account-manager.js # 多賬戶管理
│   ├── token-manager.js  # 令牌存儲和刷新
│   └── tools.js          # 身份驗證 MCP 工具
├── calendar/             # 日曆操作
├── email/               # 郵件操作
├── folder/              # 文件夾管理
├── rules/               # 郵件規則
├── utils/               # 共享工具
│   ├── graph-api.js     # Graph API 輔助工具
│   ├── odata-helpers.js # OData 查詢構建器
│   ├── permissions.js   # 權限檢查
│   └── mock-data.js     # 測試數據
├── Scripts/             # 部署和管理腳本
├── config.js            # 配置管理
├── index.js             # 主要服務器入口點
└── package.json         # 依賴項和腳本

安全

最佳實踐

• 使用環境變量存儲所有機密信息。
• 每個賬戶有獨立的令牌存儲。
• 自動刷新令牌。
• 在生產環境中強制使用 HTTPS。
• 為遠程訪問配置 CORS。

令牌管理

• 令牌存儲在 ~/.outlook-mcp-accounts/。
• 在過期前自動刷新。
• 使用唯一的賬戶 ID 安全存儲令牌。
• 在刪除賬戶時清理令牌。

故障排除

常見問題

“No accounts configured”

• 解決方案：使用 authenticate 工具添加賬戶。

“Authentication required for account X”

• 解決方案：重新對特定賬戶進行身份驗證。

瀏覽器中出現 CORS 錯誤

• 解決方案：檢查你的域名的 CORS 配置。

端口已被使用

• 解決方案：更改 MCP_PORT 環境變量。

健康檢查

• 本地：使用 check-auth-status 工具。
• 遠程：訪問 http://localhost:3001/health。

日誌

• 服務器日誌輸出到標準錯誤輸出。
• 使用賬戶 ID 記錄身份驗證事件。
• 記錄錯誤詳細信息以進行調試。

開發

先決條件

• Node.js 14+
• Azure 應用註冊
• Microsoft Graph API 權限

腳本

• npm start - 本地標準輸入輸出模式
• npm run start-remote - 遠程 HTTP 模式
• npm run auth-server - 僅啟動 OAuth 服務器
• npm run test-mode - 使用模擬數據運行
• npm run inspect - 使用 MCP 檢查器運行

貢獻

1. 分叉倉庫。
2. 創建功能分支。
3. 編寫測試並進行更改。
4. 更新文檔。
5. 提交拉取請求。

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

支持

• GitHub 問題：報告錯誤
• 文檔：本 README
• MCP 協議：modelcontextprotocol.io
• Microsoft Graph：docs.microsoft.com/graph