金大哥 - Azure Impact Reporter MCP 详情

article

README

🚀 MCP-Server-Azure-Impact-Reporting

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

🚀 快速开始

Azure影响报告MCP服务器是一款强大的工具，能助力大型语言模型向Azure资源报告影响。下面为您详细介绍使用步骤。

✨ 主要特性

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

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

影响类别

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

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提交报告。

示例对话： alt text

高级用法

当需要更多信息时：

请求详细信息
推断详细信息并报告影响

📚 详细文档

API文档

该工具支持以下接口： | 属性 | 详情 | |------|------| | 接口地址 | POST /api/report | | 描述 | 提交影响报告 | | 参数 | source, type, details |

📄 许可证

[此处添加许可证信息]

⚠️ 重要提示

请确保安装了所有必要的依赖项。
在生产环境中使用前，请测试所有功能。

👥 贡献者

[您的名字] - 初始实现

Azure Impact Reporter