JinDaGe - MCP-Server-Azure-Impact-Reporting MCP Details

article

README

🚀 Azure 影响报告 MCP 服务器

Azure 影响报告 MCP 服务器可助力大型语言模型（LLMs）向 Azure 资源报告影响。当客户遭遇 Azure 基础设施问题时，该工具能让 LLMs 自动解析用户请求、明确所需参数，并向 Azure 提交报告。

🚀 快速开始

在使用 Azure 影响报告 MCP 服务器前，请确保满足以下先决条件，并按照设置说明进行操作。

先决条件

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 的客户端，服务器将在需要时自动启动。

✨ 主要特性

impact-reporter.py 脚本提供了一个 MCP 服务器，具备以下功能：

提供向 Azure 汇报资源影响的工具。
使用 DefaultAzureCredential 自动向 Azure 进行身份验证。
通过 Azure 管理 API 创建工作负载影响报告。
处理从自然语言请求中提取参数。
当请求缺少所需信息时，可要求提供更多细节。

影响类别

该工具支持以下影响类别：

Resource.Connectivity - 针对 Azure 资源连接性问题
Resource.Performance - 针对性能降级问题
Resource.Availability - 针对可用性或停机时间问题
Resource.Unknown - 当具体问题类型未知时

💻 使用示例

基础用法

配置完成后，你的 LLM 可以通过自然语言请求报告影响，例如：

“报告名为 'web-server' 的 VM 在资源组 'production-rg' 中的连接性问题”
“让 Azure 知道我的 SQL 数据库 'customer-db' 在 'data-rg' 中存在性能问题”
“报告我的'app-service' 是下线的状态”

MCP 服务器将自动解析这些请求并在缺少参数时要求提供更多细节，然后提交报告到 Azure。

示例对话： alt text

当需要更多细节时：

请求额外信息
提供更多信息后继续

🔧 技术细节

支持的资源类型：虚拟机、数据库、存储帐户等。
影响报告包括：性能指标、错误日志、资源状态等。
自动生成修复建议：基于收集的数据提供解决方案。

📚 详细文档

图像说明

ReportImpact.png：显示影响报告生成过程。
RequestDetails.png：显示请求额外细节的界面。

MCP-Server-Azure-Impact-Reporting