MCP Server Graph Api

🚀 使用 Microsoft Graph API の Model-context-protocol (MCP) サーバー

このプロジェクトは、Microsoft Graph API を使用した Model-context-protocol (MCP) サーバーを提供します。Claude Desktop アプリなどの MCP クライアントと連携して、特定の機能を実現します。

🚀 クイックスタート

🔍 前提条件

Entra ID アプリケーション

1. 新しい Entra ID アプリケーションを登録します。
2. 少なくとも User.Read.All アプリケーション権限を追加して付与します。必要に応じて、他の権限を追加できます。
3. 新しいクライアント シークレットを作成します。

Claude Desktop アプリ

• 私は Claude Desktop アプリ を使用していますが、ローカル MCP サーバーをサポートする他の MCP クライアント（GitHub Copilot など、許可されている場合）を使用することもできます。

📦 MCP サーバーの設定

1. ソリューションを開いてビルドします。
2. claude_desktop_config.json ファイルを開きます。Windows の場合、このファイルは %APPDATA%\Claude\ フォルダにあります。
3. args セクションでプロジェクト フォルダのパスを指定します。env セクションには、テナント ID、クライアント ID、クライアント シークレットを含む Entra ID アプリの情報を記入してください。

デフォルトでは、Microsoft Graph グローバル サービスが使用されます。NATIONAL_CLOUD 環境変数を変更することで、この設定を変更できます。

NATIONAL_CLOUD の可能な値

• Global: https://graph.microsoft.com - Microsoft Graph グローバル サービス
• US_GOV: https://graph.microsoft.us - Microsoft Graph for US Government L4
• US_GOV_DOD: https://dod-graph.microsoft.us - Microsoft Graph for US Government L5 (DOD)
• China: https://microsoftgraph.chinacloudapi.cn - Microsoft Graph 中国（21Vianet が運営）
• Germany: https://graph.microsoft.de - Microsoft Graph ドイツ

{
    "mcpServers": {
        "graphApi": {
            "command": "dotnet",
            "args": [
                "run",
                "--project",
                "path/to/folder/with/console_project",
                "--no-build"
            ],
            "env": {
                "TENANT_ID": "<tenant_id>",
                "CLIENT_ID": "<client_id>",
                "CLIENT_SECRET": "<client_secret>",
                "NATIONAL_CLOUD": "Global"
            }
        }
    }
}

💻 MCP サーバーの実行

1. Claude Desktop アプリを開くと、MCP サーバーが自動的に検出されて実行されます。
2. アプリがすでに開いている場合は、（システム トレイから）閉じてから再度開いて、新しい設定を認識させます。

⚠️ 注意事項

• 障害が発生した場合は、%APPDATA%\Claude\logs フォルダのログ ファイルを確認してください。