MCP-Server-Azure-Impact-Reporting

MCP-Server-Azure-Impact-Reporting

site icon
2025.04.11 2
PythonAzure资源管理问题报告金融服务
Azure Impact Reporting MCP服务器是一个基于Model Context Protocol的工具,旨在帮助大型语言模型(LLMs)报告Azure资源的影响。该工具能够自动解析用户请求,理解所需参数,并在客户遇到Azure基础设施问题时向Azure提交报告。
View on GitHub

Overview

基本能力

产品定位

Azure Impact Reporting MCP服务器是一个专门为Azure资源问题报告设计的工具,旨在通过自然语言处理技术简化问题报告流程。

核心功能

  1. 提供向Azure报告资源影响的工具
  2. 使用DefaultAzureCredential自动进行Azure身份验证
  3. 通过Azure管理API创建工作负载影响报告
  4. 处理从自然语言请求中提取参数
  5. 在请求缺少必要信息时能够询问额外细节

支持的影响类别

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

适用场景

  1. 当Azure虚拟机出现连接问题时自动报告
  2. 当SQL数据库性能下降时通知Azure
  3. 当App Service服务不可用时提交报告

工具列表

  1. impact-reporter.py - 主脚本,提供MCP服务器功能,能够处理自然语言请求并向Azure提交报告

常见问题解答

  • 认证问题:确保已登录Azure并拥有适当权限
  • 缺少参数:工具会询问需要的额外细节
  • API错误:检查Azure门户确认订阅和资源是否存在

使用教程

使用依赖

  • 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
  1. 安装依赖
pip install -r requirements.txt

或手动安装:

pip install mcp[cli] azure-identity httpx
  1. Azure认证设置 确保使用以下方法之一登录Azure:
  2. Azure CLI (az login)
  3. Visual Studio Code Azure Account扩展
  4. Azure PowerShell (Connect-AzAccount)
  5. 服务主体认证的环境变量

  6. 配置MCP客户端 在MCP客户端配置文件中添加以下配置:

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

调试方式

  1. 确保MCP服务器已正确配置并运行
  2. 使用自然语言请求测试功能,例如: "Report connectivity issues with my VM named 'web-server' in resource group 'production-rg'"
  3. 检查Azure门户确认报告是否成功提交

许可证

该项目遵循 MIT 开源许可条款。