Jbassist

🚀 JBassist - 微軟圖 MCP 服務器

JBassist 是一個兼容 Windows 的 MCP 服務器實現，它允許 Claude Desktop 通過 Microsoft Graph API 連接到 Microsoft 365 服務，為系統間的信息傳遞提供了便利。

🚀 快速開始

JBassist 是一個 MCP 服務器，藉助它，Claude Desktop 能夠通過 Microsoft Graph API 與 Microsoft 365 服務建立連接。MCP（模型上下文協議）是一種用於在不同系統之間傳遞信息的協議。

✨ 主要特性

標準 API 工具

此實現包含以下標準 Microsoft Graph API 功能：

• 用戶資料信息獲取
• 郵件收發
• 日曆操作
• 文件存儲訪問

Beta API 工具

此實現還包含了以下 beta 版本的 Microsoft Graph API 功能：

• 增強的用戶個人資料信息
• 組織關係圖譜
• 用戶狀態和存在信息
• 高級搜索功能

📦 安裝指南

先決條件

要使用此 MCP 服務器，您需要以下先決條件：

1. 安裝 Node.js 和 npm（版本要求：Node >= 14, npm >= 6）
2. 安裝 TypeScript（可選但推薦）
3. 安裝 Microsoft 圖 Graph 客戶端庫
4. 創建 Azure AD 應用註冊並獲取訪問令牌

設置步驟

1. 克隆此倉庫到本地開發環境中。
2. 在項目根目錄下創建一個 .env 文件，填寫以下內容：

   TENANT_ID=your_tenant_id
   CLIENT_ID=your_client_id
   CLIENT_SECRET=your_client_secret
   

3. 安裝依賴項：運行命令 npm install
4. 啟動服務器：運行命令 npm start

如何運行服務器

• 服務器啟動後會在控制檯輸出相關信息，並監聽指定端口。
• 可以通過配置文件調整服務器的端口號和日誌級別。

💻 使用示例

基礎用法

標準 API 示例

// 獲取當前用戶資料
GET /api/user-profile

// 發送郵件
POST /api/send-email
{
  "to": "recipient@example.com",
  "subject": "Test Email",
  "body": "This is a test email."
}

Beta API 示例

// 獲取增強的用戶個人資料
GET /api/beta-user-profile

// 搜索Marketing部門且擁有SQL技能的用戶
POST /api/search-users
{
  "department": "Marketing",
  "skills": ["SQL"]
}

🔧 技術細節

修改服務器或添加新功能

1. 編輯 src 目錄下的文件。
2. 在 src/index.ts 中按照現有模式添加新的工具。
3. 重建項目：運行命令 npm run build
4. 重啟服務器。

添加新的 Beta API 功能

1. 參考 Microsoft Graph 的 beta API 文檔。
2. 使用 graphBetaClient 實例進行 beta API 調用。
3. 由於 beta API 可能會更改，請進行充分的測試和錯誤處理。

額外的 Microsoft 圖端點

此服務器實現了基本功能，但 Microsoft Graph 提供了更多的端點。例如：

• OneNote 訪問
• SharePoint 文檔訪問
• Teams 消息訪問
• OneDrive 文件訪問
• 任務管理

請參考 Microsoft Graph 官方文檔 獲取更多信息。

📄 許可證

本項目採用 MIT 許可證。

致謝

該項目基於 Windows MCP 天氣示例項目，並針對 Microsoft Graph 進行了調整。

故障排除

1. 認證錯誤：檢查 .env 文件中的 Azure AD 應用憑據是否正確。
2. 權限錯誤：確保您的 Azure AD 應用已獲得必要的權限。
3. 連接問題：確認您已點擊 Claude Desktop 提示的 MCP 授權按鈕。
4. 日誌文件：查看 graph-server.log 文件以獲取詳細錯誤信息。