Outlook MCP Server Main

🚀 Outlook MCP 服務器

Outlook MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務，它為大語言模型和其他 MCP 客戶端提供了標準化接口，使其能夠方便地訪問 Microsoft Outlook 的郵件功能，實現郵件的讀取、搜索與管理操作。

🚀 快速開始

要使用 Outlook MCP 服務器，你需要滿足以下先決條件，並按照安裝步驟進行操作：

先決條件

• 操作系統為 Windows。
• 安裝 Python 3.11 或更高版本。
• 已安裝 Microsoft Outlook 並配置了活躍賬戶。
• 準備好 Claude Desktop 或其他 MCP 兼容客戶端。

安裝步驟

1. 克隆或下載此倉庫。
2. 安裝所需的依賴項，在命令行中執行以下命令：

pip install mcp>=1.2.0 pywin32>=305

3. 配置 Claude Desktop（或其他 MCP 客戶端）以自動啟動該服務器。

客戶端配置

將以下內容添加到你的 MCP 客戶端配置中：

{
  "mcpServers": {
    "outlook": {
      "isActive": true,
      "name": "outlook",
      "description": "Outlook 工具",
      "command": "python",
      "args": [
        "${workspaceFolder}/outlook_mcp_server.py"
      ]
    }
  }
}

✨ 主要特性

• 文件夾管理：可列出 Outlook 客戶端中的所有可用郵件文件夾。
• 郵件列表：能從指定時間段內檢索郵件。
• 郵件搜索：支持根據聯繫人姓名、關鍵詞或短語（支持 OR 運算符）搜索郵件。
• 郵件詳細信息：可查看完整的郵件內容，包括附件。
• 郵件編寫：能夠創建併發送新郵件。
• 郵件回覆：可對現有的郵件進行回覆。

💻 使用示例

基礎用法

將配置信息添加到 MCP 客戶端後，你就可以使用服務器提供的各種工具了。以下是各工具的詳細介紹：

1. list_folders：

   • 列出 Outlook 中的所有可用郵件文件夾。
   • 顯示文件夾層次結構，最多顯示三級深度。
   • 返回格式化的文件夾和子文件夾列表。

2. list_recent_emails：

   • 列出指定天數（1 - 30）內的郵件標題。
   • 可以指定要搜索的文件夾（默認為收件箱）。
   • 緩存結果以便於詳細查看。
   • 返回找到的郵件數量和查看它們的說明。

3. search_emails：

   • 根據聯繫人姓名或關鍵詞搜索郵件。
   • 支持 OR 運算符用於多個搜索詞。
   • 搜索主題、發件人名稱和正文內容。
   • 返回匹配項的數量和查看它們的說明。

4. view_email_cache：

   • 瀏覽緩存郵件，每頁顯示 5 條。
   • 顯示郵件主題、發件人、接收時間和已讀狀態。
   • 提供上一頁/下一頁導航。
   • 需要先使用 list_recent_emails 或 search_emails。

5. get_email_by_number：

   • 根據編號檢索特定郵件的詳細內容。
   • 顯示完整的正文、收件人和附件。
   • 需要從緩存列表中提供郵件編號。
   • 提供回覆郵件的選項。

6. reply_to_email_by_number：

   • 根據編號回覆特定郵件。
   • 使用緩存列表中的郵件編號。
   • 發送帶有指定正文內容的回覆。
   • 維持原始郵件線程。
   • 可選：指定“收件人”和“抄送”字段的自定義收件人。
     • 默認行為是回覆所有（發件人 + 抄送）。
     • 允許覆蓋默認收件人如果需要。

7. compose_email：

   • 創建併發送新郵件。
   • 支持收件人、主題和正文內容。
   • 可選 CC 字段用於添加更多收件人。
   • 通過 Outlook 客戶端處理郵件發送。

高級用法

示例工作流程

1. 使用 list_folders 查看所有可用的郵件文件夾。
2. 使用 list_recent_emails 查看最近的郵件（例如，過去 7 天內的）。
3. 使用 search_emails 根據關鍵詞搜索郵件。
4. 使用 view_email_cache 瀏覽緩存的郵件。
5. 使用 get_email_by_number 查看特定郵件的詳細信息。
6. 使用 reply_to_email_by_number 回覆郵件。
7. 使用 compose_email 創建併發送新郵件。

⚠️ 重要提示

⚠️ 重要提示

此服務器可以訪問你的 Outlook 郵件賬戶，並且可以讀取、發送和管理郵件。僅在受信任的 MCP 客戶端和安全環境中使用它。

🔧 技術細節

• 當前僅支持純文本郵件（不支持 HTML）。
• 最大郵件歷史限制為 30 天。
• 搜索功能依賴於 Outlook 的內置搜索功能。
• 僅支持基本郵件功能（無日曆、聯繫人等）。