MCP Msgraph

一個MCP服務器原型，用於從Microsoft Graph讀取用戶配置文件，展示MCP與Microsoft Graph數據連接的驗證概念。

開發者工具客戶數據平臺 #用戶配置 #微軟數據 #API連接 #身份驗證 .Python

評分 : 2分

下載量 : 13

更新時間 : 2025-04-28

什麼是MCP-MSGraph?

MCP-MSGraph是一個基於Model Context Protocol (MCP)的服務器，專門設計用於從Microsoft Graph中讀取用戶配置文件數據。它作為概念驗證展示瞭如何將MCP協議與Microsoft Graph數據連接。

如何使用MCP-MSGraph?

您需要先在Azure AD中註冊應用獲取API訪問權限，然後運行服務器並通過REST API發送請求來獲取用戶數據。

適用場景

適用於需要集成Microsoft 365用戶數據的應用開發，特別是需要訪問用戶配置文件的場景。

主要功能

Microsoft Graph集成無縫連接Microsoft Graph API獲取用戶數據

MCP協議支持實現標準MCP協議進行數據交互

REST API接口提供簡單的HTTP接口進行數據查詢

優勢與侷限性

優勢

快速集成Microsoft 365用戶數據

標準化的MCP協議接口

輕量級且易於部署

侷限性

目前僅支持讀取用戶配置文件

需要Azure AD管理員權限配置

功能相對基礎

如何使用

創建Azure AD應用

在Azure門戶中註冊新應用並配置API權限

設置環境

克隆倉庫並安裝依賴包

配置應用信息

在main.py中填入您的應用ID、租戶ID和客戶端密鑰

啟動服務器

運行服務器準備接收請求

使用案例

獲取用戶基本信息查詢指定用戶的基本檔案信息

常見問題

需要哪些權限才能使用此服務?

支持哪些版本的Microsoft Graph?

如何確保數據安全?

🚀 MCP-MSGraph

這是一個原型服務器，用於演示如何將 MCP (模型上下文協議) 服務器連接到存儲在 Microsoft Graph 中的數據。此項目作為概念驗證，展示瞭如何讀取用戶的配置文件。

🚀 快速開始

✨ 主要特性

演示如何將 MCP 服務器連接到 Microsoft Graph 中的數據。
作為概念驗證，展示讀取用戶配置文件的功能。

📦 安裝指南

創建 Azure AD 應用程序

登錄 Azure 門戶。
導航至 Azure Active Directory > 應用程序註冊 > 新建註冊。
創建一個新的應用程序。
記錄生成的 應用程序（客戶端）ID 和密碼。
在 API 權限 下，添加 User.Read.All（作為委託權限或應用權限，具體取決於你的需求），並授予管理員同意。

運行服務器

克隆存儲庫或設置你自己的文件夾和文件結構。
創建一個虛擬環境：

python3 -m venv venv
source venv/bin/activate

安裝所需的包：

pip install fastapi uvicorn requests requests-oauthlib pydantic

打開 main.py 並替換佔位符值為你的應用 ID、租戶 ID 和密碼。
啟動服務器

uvicorn main:app --reload

你的服務器將在 http://127.0.0.1:8000 上可用。

💻 使用示例

基礎用法

使用 curl（或其他 REST 客戶端）發送一個請求以檢索用戶的配置文件：

curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -d '{
        "action":"readUserProfile",
        "contextId":"abc123",
        "data": {"userId":"someUser@yourtenant.onmicrosoft.com"}
      }'

結果應類似於：

{"status":"success","action":"readUserProfile","contextId":"abc123","data":{"@odata.context":"https://graph.microsoft.com/beta/$metadata#users('adelev%40M365x17584779.onmicrosoft.com')/profile/$entity","id":"profileId","account@odata.context":"https://graph.microsoft.com/beta/$metadata#users('adelev%40M365x17584779.onmicrosoft.com')/profile","account":[{"id":"a1b2c3d4-e5f6-1234-5678-9abcdeff123","displayName":"John Doe","surname":"Doe","givenName":"John","emailAddress":"john.doe@company.com","phoneNumbers":["+1 234 567 890"],"mobilePhone":"+1 234 567 890","address":{"streetAddress":"123 Main St","city":"New York","state":"NY","postalCode":"10001","country":"USA"},"createdDateTime":"2023-01-01T00:00:00Z","modifiedDateTime":"2023-01-01T00:00:00Z"},{"id":"e5f6g7h8-i9j0-k1l2-m3n4-o5p6q7r8s9t","displayName":"Jane Smith","surname":"Smith","givenName":"Jane","emailAddress":"jane.smith@company.com","phoneNumbers":["+1 543 210 9876"],"mobilePhone":"+1 543 210 9876","address":{"streetAddress":"456 Oak Ave","city":"Los Angeles","state":"CA","postalCode":"90001","country":"USA"},"createdDateTime":"2023-01-01T00:00:00Z","modifiedDateTime":"2023-01-01T00:00:00Z"}]}}