MCP Server Graph Api

🚀 使用 Microsoft Graph API 的 Model-context-protocol (MCP) 服務器

本項目藉助 Microsoft Graph API 搭建 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 部分填寫 Entra ID 應用的信息，包含租戶 ID、客戶端 ID 和客戶端密鑰。

默認採用 Microsoft Graph 全球服務。您可通過修改 NATIONAL_CLOUD 環境變量來更改此設置。

NATIONAL_CLOUD 的可能值

以下是配置文件示例：

{
    "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 文件夾中的日誌文件。