Azurehelp MCP Server

🚀 🧠 Azure 自助 MCP 服務器

本項目是一個基於 Model Context Protocol (MCP) 的實踐項目，即 Azure 故障排除器 MCP 服務器。它能讓智能代理（如 Claude 或 Semantic Kernel）逐步診斷和修復 Azure 資源。簡單來說，它能使您的 AI 應用與 Azure 的 Guided Troubleshooter 對話，實現常見故障排除工作流的自動化。

🚀 快速開始

此項目實現了一個 MCP 服務器，將 Azure 的自幫助 API 暴露為工具集。一旦連接到支持 MCP 的主機（如 Claude Desktop 或 SK 應用），您可以讓 AI 助手通過調用這些工具來解決問題。

✨ 主要特性

• 實現 MCP 服務器，將 Azure 自幫助 API 暴露為工具集。
• 讓 AI 應用與 Azure 的 Guided Troubleshooter 對話，自動化常見故障排除工作流。

📦 安裝指南

先決條件

要使用此項目，您需要以下內容：

• .NET 8 SDK：用於構建和運行服務器。
• Azure CLI：用於與 Azure 服務交互，並確保已登錄您的賬戶。
• Claude App 或其他支持 MCP 的主機：用於連接和控制故障排除流程。

安裝包

在 packages.config 中添加以下 NuGet 包：

<package id="ModelContextProtocol" version="1.0.0" />
<package id="Microsoft.Extensions.Hosting" version="6.0.0" />
<package id="Azure.ResourceManager.SelfHelp" version="1.0.0" />
<package id="Azure.Identity" version="1.4.0" />

在終端中運行以下命令以安裝這些包：

dotnet add package ModelContextProtocol --version 1.0.0
dotnet add package Microsoft.Extensions.Hosting --version 6.0.0
dotnet add package Azure.ResourceManager.SelfHelp --version 1.0.0
dotnet add package Azure.Identity --version 1.4.0

💻 使用示例

基礎用法

配置服務器

在 Program.cs 文件中，配置服務宿主：

using Microsoft.Extensions.Hosting;
using ModelContextProtocol;

public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    private static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHost(webBuilder =>
                webBuilder.UseStartup<Startup>())
            .UseMcpServer(new McpServerOptions
            {
                Input = System.Console.OpenStandardInput(),
                Output = System.Console.OpenStandardOutput()
            });
}

創建工具

在 AzureTroubleshooterTools.cs 文件中，定義故障排除工具：

using Microsoft.Azure.ResourceManager.SelfHelp;
using ModelContextProtocol;

public static class AzureTroubleshooterTools
{
    public static async Task<string> CreateTroubleshootSession()
    {
        // 初始化 Azure 客戶端
        var armClient = new ArmClient(new DefaultAzureCredential());
        var troubleshooterResource = await armClient.GetSelfHelpAsync();
        
        return $"故障排除會話已創建。可用工具：{string.Join(", ", troubleshooterResource.Tools)}";
    }

    public static async Task<string> GetTroubleshootStep(string sessionId)
    {
        // 獲取故障排除步驟
        var armClient = new ArmClient(new DefaultAzureCredential());
        var troubleshooterResource = await armClient.GetSelfHelpAsync();
        
        return $"步驟 ID：{sessionId}，請按照以下提示操作：{troubleshooterResource.Tools.FirstOrDefault(t => t.Id == sessionId)?.Instructions}";
    }

    public static async Task<string> ResetTroubleshootSession()
    {
        var armClient = new ArmClient(new DefaultAzureCredential());
        await armClient.ResetSelfHelpAsync();
        
        return "故障排除會話已重置。請重新開始。";
    }
}

配置 MCP 主機

在 appsettings.json 中，配置 MCP 主機以使用您的工具：

{
  "Mcp": {
    "Hosts": [
      {
        "Name": "AzureTroubleshooter",
        "Type": "Process",
        "Command": "dotnet",
        "Arguments": ["run"],
        "WorkingDirectory": "YourProjectPath"
      }
    ]
  }
}

啟動服務器

在終端中運行以下命令以啟動服務器：

dotnet run

使用工具

現在，您可以使用 MCP 主機（如 Claude）調用這些工具來逐步解決問題。例如：

1. 創建故障排除會話：

{
  "tool": "AzureTroubleshooter.CreateTroubleshootSession"
}

2. 獲取故障排除步驟：

{
  "tool": "AzureTroubleshooter.GetTroubleshootStep",
  "sessionId": "123"
}

3. 重置故障排除會話：

{
  "tool": "AzureTroubleshooter.ResetTroubleshootSession"
}

🎯 為什麼這很重要

通過構建一個基於 MCP 的 Azure 自幫助服務器，您可以讓 AI 應用以更智能、更高效的方式處理雲資源的問題。這種方法不僅可以提高故障排除的效率，還可以擴展到其他 Microsoft API。

💡 使用建議

💡 使用建議

• 確保您的 Azure 賬戶有足夠的權限來執行故障排除操作。
• 在生產環境中，建議使用適當的錯誤處理和日誌記錄機制。
• 可以根據需要擴展工具的功能，例如添加更多故障排除步驟或集成第三方服務。

希望這些步驟能幫助您成功構建一個基於 MCP 的 Azure 故障排除服務器！如果有任何問題，請隨時提問。