Azurehelp MCP Server

🚀 🧠 Azure 自助 MCP サーバー

このプロジェクトは、Model Context Protocol (MCP) をベースにした実践的なプロジェクトで、Claude や Semantic Kernel などのインテリジェントエージェントが Azure リソースの診断と修復を段階的に行えるようにすることを目的としています。

簡単に言えば、このプロジェクトにより、あなたの AI アプリケーションが Azure の Guided Troubleshooter と対話し、一般的なトラブルシューティングワークフローを自動化できるようになります。

🚀 クイックスタート

このセクションでは、Azure 自助 MCP サーバーをすばやくセットアップして使用する手順を説明します。

✨ 主な機能

• このプロジェクトは MCP サーバー を実装し、Azure の自助 API をツールセットとして公開します。
• サポートされている MCP ホスト（Claude Desktop や SK アプリなど）に接続すると、AI アシスタントがこれらのツールを呼び出して問題を解決できます。

📦 インストール

📋 前提条件

このプロジェクトを使用するには、以下が必要です。

• .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 トラブルシューティングサーバーを成功させることができます。何か質問があれば、いつでもお問い合わせください。