┌──────────────────────┐     Streamable HTTP      ┌──────────────────────────┐
│                      │       POST /mcp           │                          │
│   MCP Client         │─────────────────────────▶ │   FastAPI + FastMCP      │
│  (Claude Desktop,    │                           │   (Cloud Run)            │
│   Cursor, etc.)      │◀─────────────────────────│                          │
│                      │       JSON Response       │                          │
└──────────────────────┘                           └────────┬────────┬────────┘
                                                            │        │
                                              MSAL Token    │        │  Graph API
                                              Request       │        │  Calls
                                                            ▼        ▼
                                                   ┌────────────┐ ┌────────────────┐
                                                   │ Microsoft  │ │ Microsoft      │
                                                   │ Entra ID   │ │ Graph API      │
                                                   └────────────┘ └────────────────┘

MS-Graph-MCP-Server_for_Cloud_Run/
├── app/
│   ├── __init__.py          # パッケージ初期化
│   ├── main.py              # ① エントリーポイント（FastAPI + MCP マウント）
│   ├── graph_client.py      # ② Microsoft Graph API クライアント
│   └── mcp_tools.py         # ③ MCP ツール定義（①と②の橋渡し）
├── requirements.txt         # Python 依存パッケージ
├── Dockerfile               # マルチステージ Docker ビルド
├── deploy.sh                # GCP Cloud Run デプロイスクリプト
├── Gemini.md                # プロジェクト仕様書
└── README.md                # 本ドキュメント

リクエスト → FastAPI (main.py) → /mcp → FastMCP → ツール実行 → レスポンス

mcp_tools.py → MSGraphClient → MSAL (トークン取得) → httpx (Graph API 呼び出し)

MCP Client → FastMCP → mcp_tools.py (ツール定義) → graph_client.py (API 呼出) → Graph API

main.py ──imports──▶ mcp_tools.py ──imports──▶ graph_client.py
  │                      │                         │
  │ FastMCP 初期化        │ ツール登録               │ MSAL 認証
  │ FastAPI マウント      │ エラーハンドリング        │ Graph API 通信
  │ lifespan 管理        │ レスポンス整形            │ シークレット取得
  ▼                      ▼                         ▼
 HTTP 層              インターフェース層           インフラ/通信層

https://<YOUR_CLOUD_RUN_URL>/mcp

{
  "mcpServers": {
    "ms-graph": {
      "url": "https://<YOUR_CLOUD_RUN_URL>/mcp",
      "transport": "streamable-http"
    }
  }
}

from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    async with streamablehttp_client("https://<YOUR_CLOUD_RUN_URL>/mcp") as (
        read_stream, write_stream, _
    ):
        async with ClientSession(read_stream, write_stream) as session:
            await session.initialize()

            # ツール一覧の取得
            tools = await session.list_tools()
            print(tools)

            # メール下書き作成の例
            result = await session.call_tool(
                "create_email_draft",
                arguments={
                    "user_email": "user@example.com",
                    "subject": "テスト件名",
                    "body_html": "<p>テスト本文</p>",
                    "to_recipients": ["recipient@example.com"],
                },
            )
            print(result)

# gcloud CLI で ID トークンを取得
TOKEN=$(gcloud auth print-identity-token)
curl -H "Authorization: Bearer ${TOKEN}" https://<YOUR_CLOUD_RUN_URL>/health

# リポジトリをクローン
git clone <repository-url>
cd MS-Graph-MCP-Server_for_Cloud_Run

# 仮想環境を作成・有効化
python3 -m venv .venv
source .venv/bin/activate

# 依存パッケージをインストール
pip install -r requirements.txt

export TENANT_ID="your-azure-tenant-id"
export CLIENT_ID="your-azure-client-id"
export CLIENT_SECRET="your-azure-client-secret"

# uvicorn で起動
uvicorn app.main:app --host 0.0.0.0 --port 8080 --reload

# ヘルスチェック
curl http://localhost:8080/health
# → {"status":"healthy","service":"ms-graph-mcp-server"}

# MCP Inspector を使ってツール一覧・動作確認
mcp dev app/main.py

# 1. 環境変数を設定
export GCP_PROJECT_ID="your-gcp-project-id"
export GCP_REGION="asia-northeast1"       # 任意（デフォルト: asia-northeast1）

# 2. シークレットの値を登録（初回のみ）
echo -n "YOUR_TENANT_ID"     | gcloud secrets versions add TENANT_ID     --data-file=- --project=${GCP_PROJECT_ID}
echo -n "YOUR_CLIENT_ID"     | gcloud secrets versions add CLIENT_ID     --data-file=- --project=${GCP_PROJECT_ID}
echo -n "YOUR_CLIENT_SECRET" | gcloud secrets versions add CLIENT_SECRET --data-file=- --project=${GCP_PROJECT_ID}

# 3. デプロイ実行
chmod +x deploy.sh
./deploy.sh

# 直近のログを確認
gcloud run services logs read ms-graph-mcp-server \
    --region=asia-northeast1 \
    --project=${GCP_PROJECT_ID} \
    --limit=100

# リアルタイムでログを追跡
gcloud run services logs tail ms-graph-mcp-server \
    --region=asia-northeast1 \
    --project=${GCP_PROJECT_ID}

# 1. Secret Manager に新しい値を追加
echo -n "NEW_CLIENT_SECRET" | gcloud secrets versions add CLIENT_SECRET \
    --data-file=- --project=${GCP_PROJECT_ID}

# 2. Cloud Run サービスを再デプロイ（最新のシークレットバージョンを取得）
gcloud run services update ms-graph-mcp-server \
    --region=asia-northeast1 \
    --project=${GCP_PROJECT_ID} \
    --set-secrets="TENANT_ID=TENANT_ID:latest,CLIENT_ID=CLIENT_ID:latest,CLIENT_SECRET=CLIENT_SECRET:latest"

# 仮想環境内で最新バージョンを確認
pip list --outdated

# requirements.txt を更新後、再デプロイ
./deploy.sh