Outlook

🚀 拡張版Outlook MCPサーバー

このサーバーは、Microsoft Graph APIを介してClaudeをMicrosoft Outlookに接続する、拡張されたモジュール型のOutlook MCP（モデルコンテキストプロトコル）サーバーの実装です。このサーバーは、電子メール、カレンダー、フォルダー管理、およびルール作成のための強力なツールセットを提供します。

✨ 主な機能

• 完全な認証システム：OAuth 2.0をサポートするMicrosoft Graph API認証。トークンの自動更新とマルチユーザーサポート付き。
• 電子メール管理：電子メールの一覧表示、検索、閲覧、送信、および整理。添付ファイルの処理もサポート。
• カレンダー統合：カレンダーイベントの作成、編集、および管理。参加者の追跡も可能。
• フォルダー管理：電子メールフォルダーの作成、管理、およびナビゲーション。
• ルールエンジン：複雑なメール処理ルールの作成と管理。
• モジュール型アーキテクチャ：明確な階層構造により、保守性と拡張性が向上。
• 強化されたエラー処理：詳細なエラーメッセージとログ記録。
• テストモード：APIを実際に呼び出さずに、テスト用の模擬応答を提供。
• レート制限：APIの制限を防止するための組み込みレート制限。
• 多環境構成：開発、テスト、および本番環境をサポート。

📚 ディレクトリ構造

/enhanced-outlook-mcp/
├── index.js                     # メインエントリーファイル
├── config.js                    # 設定ファイル
├── .env.example                 # 環境変数のサンプル
├── auth/                        # 認証モジュール
│   ├── index.js                 # 認証のエクスポート
│   ├── token-manager.js         # トークンの保存と更新
│   ├── multi-user-support.js    # マルチユーザーサポート
│   └── tools.js                 # 認証関連のツール
├── email/                       # 電子メール機能
│   ├── index.js                 # 電子メールのエクスポート
│   ├── list.js                  # 電子メールの一覧表示
│   ├── search.js                # 電子メールの検索
│   ├── read.js                  # 電子メールの閲覧
│   ├── send.js                  # 電子メールの送信
│   └── attachments.js           # 電子メール添付ファイルの処理
├── calendar/                    # カレンダー機能
│   ├── index.js                 # カレンダーのエクスポート
│   ├── create-event.js          # カレンダーイベントの作成
│   ├── list-events.js           # カレンダーイベントの一覧表示
│   ├── update-event.js          # カレンダーイベントの更新
│   └── delete-event.js          # カレンダーイベントの削除
├── folder/                      # フォルダー管理
│   ├── index.js                 # フォルダーのエクスポート
│   ├── list.js                  # フォルダーの一覧表示
│   ├── create.js                # フォルダーの作成
│   └── move.js                  # フォルダー内の項目の移動
├── rules/                       # メールルール機能
│   ├── index.js                 # ルールのエクスポート
│   ├── create.js                # メールルールの作成
│   ├── list.js                  # メールルールの一覧表示
│   └── delete.js                # メールルールの削除
└── utils/                       # ユーティリティ関数
    ├── graph-api.js             # Microsoft Graph APIのヘルパー
    ├── odata-helpers.js         # ODataクエリのビルダー
    ├── logger.js                # ログ記録ツール
    ├── rate-limiter.js          # APIのレート制限
    └── config.js                # 設定ファイル

📦 インストール

1. リポジトリをクローンする：

   git clone https://github.com/your-repository/enhanced-outlook-mcp.git
   cd enhanced-outlook-mcp
   

2. 依存関係をインストールする：

   npm install
   

3. 環境変数を設定する：

   • .env ファイルを作成します（まだ作成されていない場合）。
   • 以下の内容を追加します：

     PORT=3000
     GRAPH_API_KEY=your_graph_api_key_here
     

4. サーバーを起動する：

   npm start
   

💻 使用例

基本的な設定

config.js ファイルで、必要に応じてポートやその他の設定をカスタマイズできます。

認証

OAuth 2.0を使用して認証します。有効なMicrosoft Graph APIトークンを提供する必要があります。

カレンダー統合

create-event.js などの関連ファイルを呼び出すことで、カレンダーイベントを管理できます。

🔧 開発

• 新機能の追加：対応するモジュールに新しい機能を追加します。
• デバッグ：console.log やその他のデバッグツールを使用してデバッグします。
• テスト：単体テストを実行して、コードの正しさを確認します。

📄 ライセンス

MITライセンス

貢献

貢献を歓迎します！自由にPull Requestを送信してください。