Azurehelp MCP Server

🚀 Azure Hands-On MCP Server

This is a hands-on project based on the Model Context Protocol (MCP), designed to enable intelligent agents (such as Claude or Semantic Kernel) to diagnose and repair Azure resources step by step.

In short, it allows your AI applications to communicate with Azure's Guided Troubleshooter, automating common troubleshooting workflows.

🚀 Quick Start

This project implements an MCP server that exposes Azure's self-help APIs as a toolset. Once connected to an MCP-enabled host (such as Claude Desktop or an SK application), you can let the AI assistant solve problems by invoking these tools.

✨ Features

By building an MCP-based Azure self-help server, your AI applications can handle cloud resource issues in a smarter and more efficient way. This approach not only improves troubleshooting efficiency but can also be extended to other Microsoft APIs.

📦 Installation

Prerequisites

To use this project, you need the following:

• .NET 8 SDK: Used to build and run the server.
• Azure CLI: Used to interact with Azure services. Make sure you are logged in to your account.
• Claude App or other MCP-enabled hosts: Used to connect and control the troubleshooting process.

Install Packages

Add the following NuGet packages to packages.config:

<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" />

Run the following commands in the terminal to install these packages:

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

Configure the Server

In the Program.cs file, configure the service host:

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()
            });
    }
}

Create Tools

In the AzureTroubleshooterTools.cs file, define the troubleshooting tools:

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

public static class AzureTroubleshooterTools
{
    public static async Task<string> CreateTroubleshootSession()
    {
        // Initialize the Azure client
        var armClient = new ArmClient(new DefaultAzureCredential());
        var troubleshooterResource = await armClient.GetSelfHelpAsync();
        
        return $"Troubleshooting session created. Available tools: {string.Join(", ", troubleshooterResource.Tools)}";
    }

    public static async Task<string> GetTroubleshootStep(string sessionId)
    {
        // Get the troubleshooting step
        var armClient = new ArmClient(new DefaultAzureCredential());
        var troubleshooterResource = await armClient.GetSelfHelpAsync();
        
        return $"Step ID: {sessionId}, please follow these instructions: {troubleshooterResource.Tools.FirstOrDefault(t => t.Id == sessionId)?.Instructions}";
    }

    public static async Task<string> ResetTroubleshootSession()
    {
        var armClient = new ArmClient(new DefaultAzureCredential());
        await armClient.ResetSelfHelpAsync();
        
        return "Troubleshooting session reset. Please start over.";
    }
}

Configure the MCP Host

In appsettings.json, configure the MCP host to use your tools:

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

Start the Server

Run the following command in the terminal to start the server:

dotnet run

💻 Usage Examples

Basic Usage

Now, you can use an MCP host (such as Claude) to invoke these tools to solve problems step by step. For example:

1. Create a troubleshooting session:

{
  "tool": "AzureTroubleshooter.CreateTroubleshootSession"
}

2. Get a troubleshooting step:

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

3. Reset the troubleshooting session:

{
  "tool": "AzureTroubleshooter.ResetTroubleshootSession"
}

📚 Documentation

Tips

• Ensure that your Azure account has sufficient permissions to perform troubleshooting operations.
• In a production environment, it is recommended to use appropriate error handling and logging mechanisms.
• You can extend the functionality of the tools as needed, such as adding more troubleshooting steps or integrating third-party services.

Hope these steps help you successfully build an MCP-based Azure troubleshooting server! If you have any questions, feel free to ask.