Outlook Email Processor

🚀 電子郵件處理 MCP 服務器

本 MCP 服務器具備強大的電子郵件處理能力，它集成了 MongoDB 用於語義搜索，同時結合 SQLite 實現高效的電子郵件存儲與檢索。

🚀 快速開始

此 MCP 服務器提供了一系列豐富的功能，可對 Outlook 電子郵件進行高效處理，同時支持多郵箱操作，為用戶帶來便捷的郵件管理體驗。

✨ 主要特性

當前功能

• 能夠處理帶有日期範圍過濾的 Outlook 電子郵件，方便用戶篩選特定時間段內的郵件。
• 在 SQLite 數據庫中存儲電子郵件，並進行適當的連接管理，確保數據的穩定存儲。
• 藉助 Ollama 生成向量嵌入，為後續的語義搜索等功能提供支持。
• 支持多郵箱，滿足用戶管理多個郵箱的需求。
• 支持 Inbox、Sent Items 和可選的 Deleted Items 文件夾，全面覆蓋常見的郵件文件夾。

待實現功能

• 帶有語義能力的電子郵件搜索，提升搜索的準確性和效率。
• 使用 LLM 的電子郵件摘要，幫助用戶快速瞭解郵件內容。
• 自動電子郵件分類，實現郵件的智能分類管理。
• 可自定義的電子郵件報告，滿足用戶個性化的報告需求。
• 高級過濾選項，提供更精細的郵件過濾方式。
• Outlook 草擬電子郵件響應，節省用戶回覆郵件的時間。
• Outlook 規則建議，為用戶提供合理的郵件規則設置。
• 擴展數據庫選項，集成 Neo4j 和 ChromaDB，增強數據存儲和處理能力。

📦 安裝指南

先決條件

• 需要 Python 3.10 或更高版本。
• Ollama 需在本地運行（用於嵌入）。
• 需安裝 Microsoft Outlook。
• 操作系統為 Windows（用於 Outlook 集成）。
• 需要 MongoDB 服務器（用於存儲嵌入）。

安裝步驟

1. 安裝 uv（如果尚未安裝）：

   pip install uv
   

2. 創建虛擬環境：

   uv venv .venv
   

3. 激活虛擬環境：
   • Windows:

   .venv\Scripts\activate
   

   • macOS/Linux:

   source .venv/bin/activate
   

4. 安裝依賴項：

uv pip install -e .

5. 安裝 fastmcp 包：

uv pip install fastmcp

6. 確保 Ollama 本地運行並安裝所需模型：

ollama pull nomic-embed-text

📚 詳細文檔

配置

將服務器添加到您的 Claude for Desktop 配置文件中：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "outlook-email": {
      "command": "C:/Users/username/path/to/mcp-server-outlook-email/.venv/Scripts/python",
      "args": [
        "C:/Users/username/path/to/mcp-server-outlook-email/src/mcp_server.py"
      ],
      "env": {
        "MONGODB_URI": "mongodb://localhost:27017/MCP?authSource=admin",
        "SQLITE_DB_PATH": "email_processing.db",
        "OLLAMA_HOST": "localhost",
        "OLLAMA_PORT": 11434
      }
    }
  }
}

示例用法在 Claude 中

"Process emails from February 1st to February 17th from all mailboxes"

架構

服務器採用混合搜索方法：

1. SQLite 數據庫：
   • 作為主電子郵件存儲庫。
   • 具備全文搜索功能。
   • 可進行處理狀態跟蹤。
   • 支持高效過濾。
   • 若目錄不存在，可自動創建。
   • 服務器關閉時，會正確關閉連接，防止“無法操作已關閉數據庫”錯誤。
2. MongoDB：
   • 用於存儲嵌入式向量。
   • 支持語義相似性搜索。
   • 可進行元數據過濾。
   • 實現高效檢索。
   • 服務器關閉後，會正確關閉連接。

錯誤處理

服務器提供詳細的錯誤消息，針對以下常見問題：

• 無效日期格式。
• 與 Outlook 的連接問題。
• MongoDB 錯誤。
• 嵌入式生成失敗並帶有重試邏輯。
• SQLite 存儲錯誤。
• Ollama 服務器連接問題的自動重試。

資源管理

服務器實現了適當的資源管理，以防止出現問題：

• 數據庫連接（SQLite 和 MongoDB）在服務器生命週期內保持打開狀態，防止“無法操作已關閉數據庫”錯誤。
• 連接僅在服務器關閉時關閉，使用 atexit 處理器。
• 使用破壞性和上下文管理器作為最後手段，確保連接在對象垃圾回收時關閉。
• 旨在平衡資源使用與運營可靠性的連接管理。
• 針對外部服務（如 Ollama）採用健壯的重試邏輯，以處理臨時連接問題。

安全注意事項

• 服務器僅處理指定郵箱的電子郵件。
• 所有數據本地存儲（SQLite）並存儲在 MongoDB 中。
• 除本地 Ollama 服務器外，不進行任何外部 API 調用。
• 需要明確用戶批准才能進行電子郵件處理。
• 通過 MCP 接口不會暴露任何敏感的電子郵件數據。

調試

遇到問題時，可按以下步驟進行排查：

1. 驗證電子郵件是否成功處理（檢查 process_emails 響應）。
2. 確保 Ollama 服務器在嵌入生成期間運行。
3. 檢查 SQLite 數據庫是否可訪問。
4. 驗證 MongoDB 連接是否正常工作。