Outlook MCP Server

🚀 Outlook MCP 服務器

Outlook MCP 服務器是一個提供 Microsoft Outlook 郵件功能訪問的模型上下文協議（MCP）服務器。它允許大語言模型（LLMs）和其他 MCP 客戶端，通過標準化接口讀取、搜索和管理郵件，為郵件操作提供了便捷、高效的解決方案。

🚀 快速開始

Outlook MCP 服務器可讓大語言模型和 MCP 客戶端通過標準化接口，對 Outlook 郵件進行讀取、搜索和管理。使用前需確保滿足先決條件，完成安裝和配置。

✨ 主要特性

• 文件夾管理：能夠列出 Outlook 客戶端中的可用郵件文件夾，方便用戶快速定位所需文件夾。
• 郵件列表：可按時間段檢索郵件，用戶能根據自己的需求查看特定時間段內的郵件。
• 郵件搜索：支持通過聯繫人姓名、關鍵詞或短語（支持 OR 運算符）搜索郵件，提高查找郵件的效率。
• 郵件詳情：可以查看完整的郵件內容，包括附件，讓用戶全面瞭解郵件信息。
• 郵件撰寫：允許用戶創建併發送新郵件，滿足日常郵件溝通需求。
• 郵件回覆：支持回覆現有郵件，方便用戶及時響應郵件。

📦 安裝指南

先決條件

• 需使用 Windows 操作系統。
• Python 版本需為 3.10 或更高版本。
• Microsoft Outlook 已安裝並配置了有效的帳戶。
• 安裝了 Claude Desktop 或其他與 MCP 兼容的客戶端。

安裝步驟

1. 克隆或下載此倉庫。
2. 安裝所需的依賴項：

pip install mcp>=1.2.0 pywin32>=305

3. 配置 Claude Desktop（或其他首選 MCP 客戶端）以使用此服務器。

配置

Claude Desktop 配置

在你的 MCP_client_config.json 文件中添加以下內容：

{
  "mcpServers": {
    "outlook": {
      "command": "python",
      "args": ["Your path\\outlook_mcp_server.py"],
      "env": {}
    }
  }
}

💻 使用示例

啟動服務器

你可以直接啟動服務器：

python outlook_mcp_server.py

或者允許像 Claude Desktop 這樣的 MCP 客戶端通過配置啟動它。

可用工具

該服務器提供以下工具：

1. list_folders：列出 Outlook 中的所有可用郵件文件夾。
2. list_recent_emails：按指定天數顯示最近的郵件標題。
3. search_emails：按聯繫人姓名或關鍵詞搜索郵件。
4. get_email_by_number：檢索特定郵件的詳細內容。
5. reply_to_email_by_number：回覆特定郵件。
6. compose_email：創建併發送新郵件。

示例工作流程

1. 使用 list_folders 查看所有可用郵件文件夾。
2. 使用 list_recent_emails 查看最近的郵件（例如，過去 7 天）。
3. 使用 search_emails 搜索特定關鍵詞的郵件。
4. 使用 get_email_by_number 查看完整的郵件內容。
5. 使用 reply_to_email_by_number 回覆郵件。

具體示例

列出最近郵件

你能展示我過去 3 天內未讀郵件嗎？

搜索郵件

搜索過去一週關於 "項目更新 或 會議紀要" 的郵件

查看郵件詳情

顯示列表中第 2 封郵件的詳細信息

回覆郵件

回覆第 3 封郵件，內容為："感謝你的信息。我會審閱並明天回覆你。"

撰寫新郵件

發送一封主題為 "會議議程"、收件人為 john.doe@example.com 且正文為 "這是我們下次會議的議程..." 的郵件

📚 詳細文檔

故障排除

• 連接問題：確保 Outlook 正在運行並且配置正確。
• 權限錯誤：確保腳本有權訪問 Outlook。
• 搜索問題：對於複雜的搜索，嘗試在關鍵詞之間使用 OR 運算符。
• 郵件訪問錯誤：檢查郵箱 ID 是否有效且可訪問。
• 服務器崩潰：檢查 Outlook 的連接和穩定性。

安全注意事項

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

限制

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