MCP Msgraph

一个MCP服务器原型，用于从Microsoft Graph读取用户配置文件，展示MCP与Microsoft Graph数据连接的验证概念。

开发者工具客户数据平台 #用户配置 #微软数据 #API连接 #身份验证 .Python

评分 : 2分

下载量 : 8.1K

更新时间 : 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"}]}}