MCP Server Outlook Email

🚀 郵件處理 MCP 服務器

此 MCP 服務器專注於郵件處理，集成了 MongoDB 用於語義搜索，同時採用 SQLite 實現高效的郵件存儲與檢索，為用戶提供穩定且功能豐富的郵件處理體驗。

🚀 快速開始

此 MCP 服務器提供強大的郵件處理功能，藉助 MongoDB 實現語義搜索，利用 SQLite 完成高效存儲與檢索。以下是使用該服務器的快速指引。

✨ 主要特性

• 多郵箱支持：支持多個郵箱，滿足不同用戶的多樣化需求。
• 多文件夾處理：支持 Outlook 的 Inbox、Sent Items 文件夾，還可選擇處理 Deleted Items 文件夾。
• 高效存儲：將郵件存儲在 SQLite 數據庫中，並確保連接管理得當。
• 向量嵌入生成：使用 Ollama 生成向量嵌入，為後續的語義處理提供支持。
• 日期範圍過濾：能夠處理帶有日期範圍過濾的 Outlook 郵件。

📅 計劃功能

• 語義郵件搜索：實現帶有語義能力的郵件搜索，讓搜索更加精準。
• 郵件摘要生成：使用 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. 安裝依賴項：

   pip install -r requirements.txt
   

5. 運行服務器：

   python server.py
   

🛠️ 配置指南

將以下內容添加到配置文件中：

{
    "mongodb": {
        "uri": "mongodb://localhost:27017",
        "database": "email_processing"
    },
    "sqlite": {
        "path": "emails.db"
    },
    "ollama": {
        "url": "http://localhost:11434"
    }
}

詳細配置

• MongoDB 配置：需指定連接 URI 和數據庫名稱。
• SQLite 配置：需指定數據庫文件路徑。
• Ollama 配置：需指定服務地址。

💻 使用示例

基礎用法

獲取郵件處理狀態：

from server import EmailProcessor

processor = EmailProcessor()
status = processor.get_status()
print(status)

❌ 錯誤處理

常見的錯誤包括：

• 無效的日期格式
• Outlook 連接問題
• MongoDB 錯誤
• 嵌入生成失敗
• 數據庫存儲錯誤
• Ollama 服務器連接問題

🐞 調試指南

1. 檢查郵件是否成功處理（查看 process_emails 響應）。
2. 確保 Ollama 服務器正在運行，以便進行嵌入生成。
3. 檢查 SQLite 數據庫的訪問權限。
4. 驗證 MongoDB 連接狀態。

🔒 安全注意事項

• 服務器僅處理指定郵箱中的郵件，確保數據處理範圍可控。
• 所有數據均存儲在本地（SQLite 和 MongoDB），保障數據安全。
• 無外部 API 調用，僅與本地 Ollama 服務器通信，減少數據洩露風險。
• 郵件處理需要明確用戶批准，尊重用戶隱私。
• 無敏感郵件數據通過 MCP 接口暴露，保護用戶敏感信息。

📞 最後說明

如有任何問題或建議，請聯繫支持團隊。