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.