MCP Msgraph

🚀 MCP-MSGraph

このプロジェクトは、MCP (モデルコンテキストプロトコル) サーバーを Microsoft Graph に保存されているデータに接続する方法をデモンストレーションするプロトタイプサーバーです。これは概念実証として、ユーザーのプロファイルを読み取る方法を示しています。

🚀 クイックスタート

📦 Azure AD アプリケーションの作成

1. Azure ポータルにログインします。
2. Azure Active Directory > アプリケーション登録 > 新規登録に移動します。
3. 新しいアプリケーションを作成します。
4. 生成された アプリケーション（クライアント）ID と パスワード を記録します。
5. API アクセス許可 の下で、User.Read.All（委任アクセス許可またはアプリアクセス許可、必要に応じて）を追加し、管理者の同意を付与します。

🚀 サーバーの実行手順

1. リポジトリをクローンするか、独自のフォルダとファイル構造を設定します。
2. 仮想環境を作成します：

python3 -m venv venv
source venv/bin/activate

3. 必要なパッケージをインストールします：

pip install fastapi uvicorn requests requests-oauthlib pydantic

4. main.py を開き、アプリ ID、テナント ID、パスワードのプレースホルダー値を置き換えます。
5. サーバーを起動します：

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