Outlook MCP

🚀 モジュール化Outlook MCPサーバ

このプロジェクトは、ClaudeをMicrosoft Graph APIを介してMicrosoft Outlookに接続するための、モジュール化されたOutlook MCP（モデルコンテキストプロトコル）サーバの実装です。

📚 詳細ドキュメント

🔍 ディレクトリ構造

/modular/
├── index.js                 # エントリーファイル
├── config.js                # 設定ファイル
├── auth/                    # 認証モジュール
│   ├── index.js             # 認証エクスポート
│   ├── token-manager.js     # トークンの保存と更新
│   └── tools.js             # 認証関連ツール
├── email/                   # メール機能
│   ├── index.js             # メールエクスポート
│   ├── list.js              # メールの一覧表示
│   ├── search.js            # メールの検索
│   ├── read.js              # メールの閲覧
│   └── send.js              # メールの送信
└── utils/                   # ユーティリティ関数
    ├── graph-api.js         # Microsoft Graph APIヘルパー
    ├── odata-helpers.js     # ODataクエリの構築
    └── mock-data.js         # テストモード用のデータ

✨ 主な機能

• 認証：OAuth 2.0に基づくMicrosoft Graph API認証
• メール管理：メールの一覧表示、検索、閲覧、および送信
• モジュール化構造：明確な責務分離により、保守が容易
• ODataフィルタリング処理：ODataクエリの適切なエスケープとフォーマット
• テストモード：実際のAPI呼び出しを行わずに、テスト時に模擬応答を使用

📦 インストール

設定

サーバを設定するには、config.jsファイルを編集して以下を変更します。

• サーバ名とバージョン
• テストモード設定
• 認証パラメータ
• メールフィールドの選択
• APIエンドポイント

💻 使用例

Claude Desktopでの使用

1. claude-config-sample.jsonのサンプル設定をClaude Desktopの設定にコピーします。
2. Claude Desktopを再起動します。
3. authenticateツールを使用してMicrosoft認証を行います。
4. メールツールを使用してOutlookアカウントを管理します。

単体での実行

サーバをテストするには、以下のコマンドを使用します。

./test-modular-server.sh

これにより、MCP Inspectorを使用してサーバに直接接続し、利用可能なツールをテストできます。

🔐 認証フロー

1. ポート3333でローカル認証サーバを起動します（outlook-auth-server.jsを使用）。
2. authenticateツールを使用して認証URLを取得します。
3. ブラウザで認証を完了します。
4. トークンは~/.outlook-mcp-tokens.jsonに保存されます。

🛠️ トラブルシューティング

• 認証問題：トークンファイルと認証サーバのログを確認してください。
• ODataフィルタリングエラー：サーバログのエスケープシーケンスを確認してください。
• API呼び出し失敗：応答内の詳細なエラーメッセージを確認してください。

🔌 サーバの拡張

新しい機能を追加するには、以下の手順を実行します。

1. 新しいモジュールディレクトリを作成します（例：calendar/）。
2. 個別のファイルでツールハンドラを実装します。
3. モジュールインデックスファイルからツール定義をエクスポートします。
4. index.jsのTOOLS配列にツールをインポートして追加します。