🧠 Azure Self Help MCP Server

🧠 Azure 自助服务 MCP 服务

欢迎使用 Azure 故障排查 MCP 服务——这是 Model Context Protocol (MCP) 的实践实现，旨在让智能 Agent（如 Claude 或 Semantic Kernel）通过 Azure Self Help API，逐步排查 Azure 资源问题。

简而言之：它让你的 AI 应用可以 与 Azure Guided Troubleshooter 对话，自动执行常见诊断工作流。

---

💡 这是什么？

本项目实现了一个 MCP 服务，将 Azure 的 Self Help API 封装为一组工具。连接到 MCP Host（如 Claude Desktop 或 SK App）后，你可以让 Agent：

• 创建故障排查会话
• 查看当前步骤
• 根据你的回复继续流程
• 结束或重启会话

你可以将它视为用于 Azure 诊断的交互式 AI 助手。

---

✨ 实时演示用例

❓ “我无法通过 SSH 连接到我的 Azure VM。”

此工具可以通过 Microsoft 的 Guided Troubleshooter API，让大模型以交互方式引导你了解可能的原因和解决方案。

---

🧰 前置条件

• .NET 8 SDK
• Azure CLI（已登录）
• Claude App 或任意 MCP Host
• IDE / 终端

---

📦 设置

第 1 步：安装包

dotnet add package ModelContextProtocol --prerelease
dotnet add package Microsoft.Extensions.Hosting
dotnet add package Azure.ResourceManager.SelfHelp
dotnet add package Azure.Identity

---

第 2 步：创建 MCP 服务

在 Program.cs 中：

var builder = Host.CreateEmptyApplicationBuilder(settings: null);

builder.Services.AddMcpServer()
    .WithStdioServerTransport()
    .WithToolsFromAssembly(); // Registers [McpServerTool] methods

var app = builder.Build();
await app.RunAsync();

---

第 3 步：编写 MCP 工具

在 AzureTroubleshooterTools.cs 中：

[McpServerToolType]
public static class AzureTroubleshooterTools
{
    [McpServerTool, Description("Create a troubleshooter session")]
    public static async Task<string> CreateTroubleshooter([Description("Resource Uri of the azure resource")]string scope)
    {
        string solutionId = "e104dbdf-9e14-4c9f-bc78-21ac90382231"; // this is solutionId for vm ssh issue. This id can be found using Discovery API of Azure Help, which will also be part of this MCP Server
        string troubleshooterName = Guid.NewGuid().ToString();
        var client = new ArmClient(new DefaultAzureCredential());

        var troubleshooterId = SelfHelpTroubleshooterResource.CreateResourceIdentifier(scope, troubleshooterName);
        var troubleshooter = client.GetSelfHelpTroubleshooterResource(troubleshooterId);

        var data = new SelfHelpTroubleshooterData
        {
            SolutionId = solutionId,
            Parameters = { ["ResourceURI"] = scope }
        };

        ArmOperation<SelfHelpTroubleshooterResource> lro = await troubleshooter.UpdateAsync(WaitUntil.Completed, data);
        return $"Troubleshooter created with ID: {lro.Value.Data.Id}";
    }

    // Tools: Get, Continue, End, Restart...
}

---

🤖 Claude 或其他 Host 的 MCP 配置

要将 MCP 服务连接到 Claude 等兼容 MCP 的应用，请更新配置文件（在 Claude Desktop 中：Settings > Developer）：

{
  "mcpServers": {
    "azurehelpTroubleshooter": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "/Users/yourname/Projects/AzureTroubleshooterServer",
        "--no-build"
      ]
    }
  }
}

保存并重启后，Claude 就会检测到你的工具，随时为 Azure 诊断提供帮助！✅

---

🧪 可用工具

方法	说明
CreateTroubleshooter	为资源启动新的故障排查会话
GetTroubleshooterStep	查看当前步骤和说明
ContinueTroubleshooter	回答当前步骤的问题
EndTroubleshooter	结束会话
RestartTroubleshooter	从第一步重新开始

---

🛡 身份验证

使用 DefaultAzureCredential，因此开箱即用，支持：

• Azure CLI
• 环境变量
• 托管标识

---

🧠 为什么这很重要

Model Context Protocol (MCP) 正在彻底改变大模型与工具的交互方式。通过为 Azure Help API 构建 MCP 服务，你可以：

• 让 Azure 调试原生支持 Agent
• 为 AI 应用赋予云端智能
• 采用相同结构扩展至其他 Microsoft API

---

📎 相关文章

• 使用 Playwright MCP 服务构建可浏览互联网的 AI 应用
• MCP 服务分步指南

---

🙌 致谢

感谢出色的 Azure SDK 团队和 MCP 的创作者，让这种开发者魔法成为可能。✨

• https://learn.microsoft.com/en-us/rest/api/help/
• https://docs.anthropic.com/en/docs/agents-and-tools/mcp

---