MCP Msgraph

🚀 MCP-MSGraph

A prototype server demonstrating how to connect an MCP (Model Context Protocol) server to data stored in Microsoft Graph. This project serves as a proof of concept, showing how to read a user's profile.

🚀 Quick Start

✨ Features

This project showcases the ability to connect an MCP server to Microsoft Graph data and read user profiles.

📦 Installation

1. Create an Azure AD application:

   • Log in to the Azure portal.
   • Navigate to Azure Active Directory > App registrations > New registration.
   • Create a new application.
   • Record the generated Application (client) ID and Secret.
   • Under API permissions, add User.Read.All (either as a delegated or application permission, depending on your needs), and grant admin consent.

2. Run the server:

   • Clone the repository or set up your own folder and file structure.
   • Create a virtual environment:

python3 -m venv venv
source venv/bin/activate

- Install the required packages:

pip install fastapi uvicorn requests requests-oauthlib pydantic

- Open `main.py` and replace the placeholder values with your app ID, tenant ID, and secret.
- Start the server:

uvicorn main:app --reload

Your server will be available at http://127.0.0.1:8000.

💻 Usage Examples

Basic Usage

Use curl (or another REST client) to send a request to retrieve a user's profile:

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

The result should be similar to:

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