MCP-Server-Azure-Impact-Reporting

MCP-Server-Azure-Impact-Reporting

概要

Azure Impact Reporting MCP（Model Context Protocol）サーバーを使用すると、大規模言語モデル（LLM）が Azure リソースへの影響を報告できます。このツールを使うと、LLM がユーザーのリクエストを自動的に解析し、必要なパラメーターを理解して、Azure インフラストラクチャに問題が発生しているお客様に代わって Azure に報告を送信できます。

機能

impact-reporter.py スクリプトは、次の機能を備えた Model Context Protocol サーバーを提供します。

1. Azure にリソースへの影響を報告するツールを公開します
2. DefaultAzureCredential を使用して Azure に自動認証します
3. Azure Management API を介してワークロードへの影響レポートを作成します
4. 自然言語によるリクエストからパラメーターを抽出します
5. リクエストに必須情報が不足している場合、追加情報を尋ねます

影響カテゴリ

このツールは、次の影響カテゴリに対応しています。

• Resource.Connectivity - Azure リソースの接続に関する問題
• Resource.Performance - パフォーマンスの低下に関する問題
• Resource.Availability - 可用性またはダウンタイムに関する問題
• Resource.Unknown - 問題の種類が特定できない場合

要件

• Python 3.8+
• mcp[cli] - CLI に対応した Model Context Protocol パッケージ
• 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 Account 拡張機能
• 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"
    ]
}

uv コマンドについて

設定内の uv コマンドは、依存関係の管理に pyproject.toml を使用します。

• 仮想環境：uv は、作成済みの .venv とは別に、独自の内部仮想環境を作成して管理します
• 依存関係の管理：依存関係は pyproject.toml の仕様に基づいて自動的にインストールされます
• 分離：uv のキャッシュシステムにより、ローカルの Python 環境への干渉を防ぎます

代替方法：Python を直接実行する

uv を使用しない場合は、MCP サーバーを直接実行できます。

1. 仮想環境を作成して有効にします。

   python -m venv .venv
   # On Windows
   .venv\Scripts\activate
   # On macOS/Linux
   source .venv/bin/activate
   

2. 依存関係をインストールします。

   pip install -r requirements.txt
   

3. サーバーを直接実行します。

   python 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 'api-service' がダウンしていることを報告してください」

MCP サーバーはこれらのリクエストを自動的に解析し、Azure にレポートを送信する前に、不足しているパラメーターがあれば確認します。

会話例：

追加情報が必要な場合

1. 追加情報をリクエストします

2. 詳細を推測して影響を報告します

API の詳細

影響レポートツールは、ワークロード影響レポートを作成するために Azure Management API（2023-12-01-preview）を使用します。

トラブルシューティング

• 認証の問題：Azure にログインしており、適切な権限があることを確認してください
• パラメーターの不足：必要に応じて、ツールが追加の詳細情報を尋ねます
• API エラー：Azure ポータルで、サブスクリプションとリソースが存在することを確認してください

ライセンス

MIT ライセンス