Outlook MCP

🚀 模塊化Outlook MCP服務器

這是一個模塊化的Outlook MCP（模型上下文協議）服務器的實現，其價值在於藉助Microsoft Graph API，成功搭建起Claude與Microsoft Outlook之間的橋樑，實現二者的高效連接。

🚀 快速開始

在Claude Desktop上的使用

1. 把claude-config-sample.json裡的示例配置複製到您的Claude Desktop配置中。
2. 重啟Claude Desktop。
3. 運用authenticate工具開展Microsoft認證。
4. 利用電子郵件工具對您的Outlook賬戶進行管理。

單獨運行

若要對服務器進行測試，可使用以下命令：

./test-modular-server.sh

此命令會通過MCP Inspector直接連接到服務器，方便您對可用工具進行測試。

✨ 主要特性

• 認證：採用基於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

📚 詳細文檔

目錄結構

/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         # 測試模式數據

認證流程

1. 在3333端口啟動本地認證服務器（使用outlook-auth-server.js）。
2. 使用authenticate工具獲取認證URL。
3. 在瀏覽器中完成認證。
4. 令牌會存儲在~/.outlook-mcp-tokens.json文件中。

故障排除

• 認證問題：檢查令牌文件和認證服務器日誌。
• OData過濾錯誤：查看服務器日誌中的轉義序列。
• API調用失敗：檢查響應中的詳細錯誤消息。

擴展服務器

若要添加更多功能，可按以下步驟操作：

1. 創建新的模塊目錄（例如，calendar/）。
2. 在單獨的文件中實現工具處理程序。
3. 從模塊索引文件導出工具定義。
4. 導入並將工具添加到TOOLS數組中的index.js。