🚀 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"}]}}