Outlook Email Processor

🚀 電子メール処理 MCP サーバー

この MCP サーバーは、電子メール処理機能を提供し、MongoDB を統合して意味検索を行い、SQLite を使用して効率的なデータの保存と検索を実現します。

✨ 主な機能

• 日付範囲でフィルタリングされた Outlook 電子メールを処理します。
• SQLite データベースに電子メールを保存し、適切な接続管理を行います。
• Ollama を使用してベクトル埋め込みを生成します。
• 複数のメールボックスをサポートします。
• 受信トレイ、送信済みアイテム、およびオプションの削除済みアイテムフォルダをサポートします。

🚧 次の機能予定

• 意味検索機能を備えた電子メール検索
• LLM を使用した電子メール要約
• 自動電子メール分類
• カスタマイズ可能な電子メールレポート
• 高度なフィルタリングオプション
• Outlook の下書き電子メール応答
• Outlook ルールの提案
• Neo4j と ChromaDB を統合した拡張データベースオプション

📋 前提条件

• Python 3.10 以上
• ローカルで実行されている Ollama（埋め込み用）
• インストールされた Microsoft Outlook
• Outlook 統合に必要な Windows オペレーティングシステム
• 埋め込みを保存するための 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 で次のように入力します：

"2月1日から2月17日までのすべてのメールボックスの電子メールを処理する"

📚 ドキュメント

アーキテクチャ

サーバーは混合検索方法を採用しています：

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 接続が正常に機能していることを確認します。