Azure Impact Reporter

🚀 MCP-Server-Azure-Impact-Reporting

The MCP (Model Context Protocol) Server for Azure Impact Reporting enables Large Language Models (LLMs) to report impacts to Azure resources. This tool allows LLMs to automatically parse user requests, understand the required parameters, and submit reports to Azure when customers encounter issues with Azure infrastructure.

🚀 Quick Start

The MCP Server for Azure Impact Reporting provides a seamless way for LLMs to interact with Azure resources. After installation and configuration, LLMs can report various impacts to Azure through natural - language requests.

✨ Features

The impact - reporter.py script provides a Model Context Protocol server that:

1. Offers tools for reporting resource impacts to Azure.
2. Automatically authenticates using DefaultAzureCredential.
3. Creates workload impact reports via the Azure management API.
4. Handles parameter extraction from natural - language requests.
5. Can request more details when a request lacks necessary information.

Impact Categories

The tool supports the following impact categories:

• Resource.Connectivity - For handling connectivity issues of Azure resources.
• Resource.Performance - For dealing with performance degradation issues.
• Resource.Availability - For handling availability or downtime issues.
• Resource.Unknown - Used when the specific problem type is unknown.

📦 Installation

Prerequisites

• Python 3.8+
• mcp[cli] - Model Context Protocol package with CLI support
• azure - identity - For Azure authentication
• httpx - For sending HTTP requests to Azure API

Installation Steps

1. Clone the repository

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

2. Install dependencies

pip install -r requirements.txt

Or install manually:

pip install mcp[cli] azure-identity httpx

3. Set up Azure authentication

The tool uses DefaultAzureCredential for authentication. Ensure you are logged in to Azure using one of the following methods:

• Azure CLI (az login)
• Azure Account extension in Visual Studio Code
• Azure PowerShell (Connect - AzAccount)
• Environment variables for service principal authentication

4. Configure the MCP client

Add the following configuration to your MCP client configuration file (e.g., claude_desktop_config.json):

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

Replace ABSOLUTE_PATH_TO_ROOT_FOLDER with the absolute path of the cloned repository.

For example:

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

5. Run the MCP server

If you are using Claude Desktop or other MCP - supported clients, the server will start automatically when needed.

💻 Usage Examples

Basic Usage

After configuration, your LLM can report impacts through natural - language requests, such as:

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"

The MCP server will automatically parse these requests, request more details if necessary, and then submit reports to Azure.

Example Conversations

When more information is needed:

1. Request details

2. Infer details and report impact

📚 Documentation

API Documentation

The tool supports the following interfaces:

• POST /api/report
  • Description: Submit an impact report
  • Parameters: source, type, details

⚠️ Important Note

1. Ensure all necessary dependencies are installed.
2. Test all functions before using in a production environment.

👥 Contributors

• [Your Name] - Initial implementation

📄 License

[Add license information here]