Azure Impact Reporter

🚀 MCP-Server-Azure-Impact-Reporting

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

🚀 クイックスタート

このセクションでは、MCP-Server-Azure-Impact-Reportingの基本的な使い方を説明します。まずは必要な環境をセットアップし、その後でサーバーを起動して影響報告を行います。

✨ 主な機能

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

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

影響カテゴリ

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

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

📦 インストール

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. "Report connectivity issues with my VM named 'web-server' in resource group 'production-rg'"
2. "Let Azure know my SQL database 'customer-db' in 'data-rg' is experiencing performance issues"
3. "Report that my App Service 'api-service' is down"

MCPサーバーはこれらの要求を自動的に解析し、必要に応じて詳細を要求した後、Azureにレポートを提出します。

例の会話：

高度な使用法

必要な情報が不足している場合の処理例です。

1. 詳細を要求する

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

📚 ドキュメント

APIドキュメント

このツールは以下のインターフェースをサポートしています。

• POST /api/report
  • 説明：影響レポートを提出します。
  • パラメーター：source, type, details

🔧 注意事項

⚠️ 重要提示

1. すべての必要な依存関係がインストールされていることを確認してください。
2. 本番環境で使用する前に、すべての機能をテストしてください。

貢献者

• [あなたの名前] - 初期実装

📄 ライセンス

[ここにライセンス情報を追加]