Azure Impact Reporting MCP Server

MCP服务器Azure影响报告

概述

Azure影响报告MCP（模型上下文协议）服务器使大型语言模型（LLM）能够向Azure资源报告影响。此工具允许LLM自动解析用户请求，了解所需参数，并在客户遇到Azure基础架构问题时向Azure提交报告。

功能

这 impact-reporter.py 脚本提供了一个模型上下文协议服务器，该服务器：

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的模型上下文协议包
• 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命令行界面(az login)
• Visual Studio代码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"
    ]
}

了解 uv 命令

这 uv 配置中的命令使用 pyproject.toml 管理依赖关系：

• 虚拟环境: uv 创建和管理自己的内部虚拟环境，与任何 .venv 您可能已经创建
• 依赖管理：依赖关系将根据以下内容自动安装 pyproject.toml 规格
• 隔离：The uv 缓存系统确保不干扰本地Python环境

替代方案：直接执行Python

如果你不想使用 uv，您可以直接运行MCP服务器：

1. 创建并激活虚拟环境：

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

1. 安装依赖项：

   pip install -r requirements.txt

1. 直接运行服务器：

   python impact-reporter.py

5.运行MCP服务器

如果您将Claude与Desktop或其他启用MCP的客户端一起使用，服务器将在需要时自动启动。

使用示例

配置后，您的LLM可以报告自然语言请求的影响，例如：

1. “报告资源组'product-rg'中名为'web-server'的VM的连接问题”
2. “让Azure知道‘data rg’中的SQL数据库‘customer db’遇到性能问题”
3. “报告我的应用程序服务‘api服务’已关闭”

MCP服务器将自动解析这些请求，并在向Azure提交报告之前询问任何缺失的参数。

对话示例： alt text

当需要额外信息时

1. 要求提供更多详细信息

alt text

1. 推断细节并报告影响

alt text

API详细信息

影响报告工具使用Azure Management API（2023-12-01-review）创建工作负载影响报告。

故障排除

• 身份验证问题：确保您已登录Azure并具有适当的权限
• 缺少参数：如果需要，该工具将要求提供更多详细信息
• API错误：检查Azure门户以确保您的订阅和资源存在

许可证

MIT许可证