MCP 服务器

🧠 Azure Self Help MCP Server

这是用于引导式故障排除程序的 Azure 帮助 API 的 MCP 服务器。

akshaykokane

开发者工具

README

🧠 Azure 自助 MCP 服务器

欢迎来到 Azure 故障排除 MCP 服务器 – 这是模型上下文协议 (MCP) 的一个实践实现，旨在使智能代理（如 Claude 或 Semantic Kernel）能够使用 Azure 自助 API 逐步排除 Azure 资源故障。

简而言之：它让你的 AI 应用与 Azure 的引导式故障排除程序对话，从而实现常见诊断工作流程的自动化。

💡 这是什么？

本项目实现了一个 MCP 服务器，它将 Azure 的自助 API 作为工具集公开。连接到 MCP 主机（如 Claude Desktop 或 SK 应用）后，你可以要求代理执行以下操作：

创建故障排除程序会话
查看其当前步骤
使用你的响应继续流程
结束或重启会话

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

✨ 实时演示用例

❓ “我无法 SSH 进入我的 Azure VM。”

此工具允许 LLM 使用 Microsoft 的引导式故障排除程序 API 交互式地引导你完成可能的原因和修复。

应用运行演示

🧰 前提条件

.NET 8 SDK
Azure CLI（已登录）
Claude 应用或任何 MCP 主机
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(); // 注册 [McpServerTool] 方法

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

步骤 3：编写你的 MCP 工具

在 AzureTroubleshooterTools.cs 中：

[McpServerToolType]
public static class AzureTroubleshooterTools
{
    [McpServerTool, Description("创建故障排除程序会话")]
    public static async Task<string> CreateTroubleshooter([Description("azure 资源的资源 Uri")]string scope)
    {
        string solutionId = "e104dbdf-9e14-4c9f-bc78-21ac90382231"; // 这是 vm ssh 问题的 solutionId。可以使用 Azure Help 的 Discovery API 找到此 ID，它也将成为此 MCP 服务器的一部分
        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 $"已创建故障排除程序，ID：{lro.Value.Data.Id}";
    }

    // 工具：Get、Continue、End、Restart...
}

🤖 Claude 或其他主机的 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`	从第一步重新开始