MCP-MSGraph

Name: MCP-MSGraph
Author: kevinbellinger

@kevinbellinger

代码仓库

关于 MCP-MSGraph

A prototype MCP server which reads a user profile from Microsoft Graph.

基本信息

分类

其他

运行时

python

传输方式

stdio

发布者

kevinbellinger

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-msgraph": {
      "command": "python3",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCP-MSGraph?

MCP-MSGraph is a prototype MCP (Model Context Protocol) server that reads a user profile from Microsoft Graph. It serves as a proof of concept for connecting MCP to data stored in Microsoft Graph.

How to use MCP-MSGraph?

Clone the repository, create a Python virtual environment, install the required packages (fastapi, uvicorn, requests, requests-oauthlib, pydantic), then edit main.py to replace placeholder values with your Azure AD Application ID, Tenant ID, and Client Secret. Start the server with uvicorn main:app --reload and send an HTTP POST request to http://localhost:8000/mcp with a JSON body containing action, contextId, and data.userId.

Key features of MCP-MSGraph

Reads a user profile from Microsoft Graph via a single MCP action (readUserProfile)
Uses OAuth2 authentication with Azure AD
Runs as a local FastAPI server
Accepts requests over HTTP at the /mcp endpoint

Use cases of MCP-MSGraph

Demonstrating how an MCP server can retrieve personal data from Microsoft Graph
Prototyping AI assistants that need to query Microsoft 365 user profiles
Testing MCP integration with Microsoft identity and data platforms

FAQ from MCP-MSGraph

What exactly does MCP-MSGraph do?

It reads a user profile from Microsoft Graph using the readUserProfile action. It is a prototype and proof of concept, not a production‑ready server.

How do I get the credentials needed to run MCP-MSGraph?

You must create an Azure AD application in the Azure Portal, note the Application (client) ID and client secret, and add the User.Read.All API permission (delegated or application, with admin consent).

What are the runtime dependencies for MCP-MSGraph?

Python 3, plus the packages fastapi, uvicorn, requests, requests-oauthlib, and pydantic.

How can I test MCP-MSGraph after starting it?

Send a curl request like: curl -X POST http://localhost:8000/mcp -H "Content-Type: application/json" -d '{"action":"readUserProfile","contextId":"abc123","data":{"userId":"[email protected]"}}'. A successful response returns a JSON object with the user’s profile data.