MCP Server Azure Impact Reporting

🚀 Azure 影響レポート MCP サーバー

Azure Impact Reporting MCP（モデルコンテキストプロトコル）サーバーは、大規模言語モデル（LLMs）が Azure リソースへの影響を報告できるようにします。このツールを使用すると、LLMs はユーザーの要求を自動的に解析し、必要なパラメーターを理解し、Azure インフラストラクチャに問題がある場合に Azure にレポートを送信できます。

🚀 クイックスタート

このセクションでは、Azure 影響レポート MCP サーバーをすぐに使い始めるための手順を説明します。

✨ 主な機能

impact-reporter.py スクリプトは、以下の機能を持つ MCP サーバーを提供します。

1. Azure へのリソース影響を報告するツールを提供
2. DefaultAzureCredential を使用して Azure へ自動認証
3. Azure 管理 API を通じてワークロード影響レポートを作成
4. 自然言語の要求からパラメーターを抽出する処理
5. 要求に必要な情報が不足している場合、さらなる詳細を要求できる

影響カテゴリ

このツールは以下の影響カテゴリをサポートしています。

• Resource.Connectivity - Azure リソースの接続性問題
• Resource.Performance - パフォーマンス低下問題
• Resource.Availability - 可用性またはダウンタイム問題
• Resource.Unknown - 具体的な問題タイプが不明な場合

📦 インストール

前提条件

• Python 3.8+
• mcp[cli] - CLI サポート付きのモデルコンテキストプロトコルパッケージ
• azure-identity - Azure 認証用
• httpx - Azure API への HTTP リクエスト用

セットアップ手順

1. リポジトリをクローンする

git clone https://github.com/yourusername/MCP-Server-Azure-Impact-Reporting.git
cd MCP-Server-Azure-Impact-Reporting

2. 依存関係をインストールする

pip install -r requirements.txt

または手動でインストールする場合は、以下のコマンドを実行します。

pip install mcp[cli] azure-identity httpx

3. Azure 認証の設定

このツールは DefaultAzureCredential を使用して認証します。以下の方法のいずれかで Azure にログインしてください。

• Azure CLI (az login)
• Visual Studio Code Azure アカウント拡張機能
• Azure PowerShell (Connect-AzAccount)
• サービスプリンシパル認証の環境変数

4. MCP クライアントを構成する

MCP クライアントの設定ファイル（例：claude_desktop_config.json）に以下の設定を追加します。

"impactreporter": {
    "command": "uv",
    "args": [
        "--directory",
        "ABSOLUTE_PATH_TO_ROOT_FOLDER",
        "run",
        "impact-reporter.py"
    ]
}

ABSOLUTE_PATH_TO_ROOT_FOLDER をリポジトリをクローンした絶対パスに置き換えてください。

例：

"impactreporter": {
    "command": "uv",
    "args": [
        "--directory",
        "C:\\Users\\username\\source\\repos\\MCP-Server-Azure-Impact-Reporting",
        "run",
        "impact-reporter.py"
    ]
}

5. MCP サーバーを起動する

Claude Desktop またはその他の MCP 対応クライアントを使用している場合、サーバーは必要に応じて自動的に起動します。

💻 使用例

基本的な使用法

設定が完了すると、LLM は自然言語の要求で影響を報告できます。例えば：

1. “リソースグループ 'production-rg' 内の 'web-server' という名前の VM の接続性問題を報告する”
2. “'data-rg' 内の SQL データベース 'customer-db' のパフォーマンス問題を Azure に通知する”
3. “'app-service' がダウンしている状態を報告する”

MCP サーバーはこれらの要求を自動的に解析し、パラメーターが不足している場合はさらなる詳細を要求し、その後 Azure にレポートを送信します。

例の会話：

詳細が必要な場合：

1. 追加情報を要求する
2. 追加情報を提供して続行する

🔧 技術詳細

• サポートされるリソースタイプ：仮想マシン、データベース、ストレージアカウントなど。
• 影響レポートに含まれる内容：パフォーマンス指標、エラーログ、リソース状態など。
• 自動修復提案：収集したデータに基づいて解決策を提供します。

📚 ドキュメント

画像説明

• ReportImpact.png：影響レポートの生成プロセスを表示します。
• RequestDetails.png：追加の詳細を要求する画面を表示します。