MCP Server Outlook Email

🚀 メール処理 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
• Outlook 統合に必要な Windows オペレーティングシステム
• 埋め込みを保存するための 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 インターフェイスを通じて公開されません。

最後の注意事項

何か問題や提案がある場合は、サポートチームにお問い合わせください。