Azure Resource MCP 服务器

此 MCP 服务器提供工具，可以直接从任何 MCP 客户端列出和查询 Azure 资源，从而使您能够高效地浏览 Azure 基础设施并分析成本，而无需离开您的工作流程。

以下是如何查询 Azure 资源的示例： <img src="image/list_azure_resources.gif" width="800" height="450" />

以下是如何查询 Azure 成本的示例： <img src="image/get_azure_costs_rest.gif" width="800" height="450" />

功能

• 📊 资源发现 - 列出您所有 Azure 订阅中的所有资源
• 🔍 筛选 - 按资源组名称筛选资源
• 💰 成本分析 - 检索您的 Azure 订阅的成本信息
• 🔐 安全 - 使用您的 Azure 服务主体凭据
• 🏷️ 详细视图 - 查看所有资源的位置、类型和标签

工具

• list_azure_resources

  • 使用服务主体身份验证列出 Azure 资源组和资源
  • 输入：
    • subscription_id (字符串，可选): 要查询的特定订阅 ID。如果未提供，则使用环境变量中的默认订阅。
    • resource_group_filter (字符串，可选): 按名称筛选资源组（不区分大小写的包含匹配）。
  • 返回：格式化的 Markdown 列表，其中包含资源组及其资源，以及位置、类型和标签等详细信息。

• get_azure_costs_rest

  • 使用 REST API 获取 Azure 订阅的成本分析数据
  • 输入：
    • subscription_id (字符串，可选): 要查询的特定订阅 ID。如果未提供，则使用环境变量中的默认订阅。
    • timeframe (字符串，可选): 成本分析的时间段。默认为 "MonthToDate"。
  • 返回：格式化的 Markdown，其中包含成本分析数据，包括每日成本和总计。

配置

设置 Azure

1. 创建用于身份验证的 Azure 服务主体：

   az ad sp create-for-rbac --name {服务主体名称}

2. 向服务主体分配适当的读取者权限
3. 记下您的 Azure 订阅 ID、租户 ID、客户端 ID 和客户端密钥
4. 设置所需的环境变量

环境变量

此服务器需要以下环境变量：

# 必需的 Azure 身份验证
AZURE_TENANT_ID=您的租户 ID
AZURE_CLIENT_ID=您的客户端 ID
AZURE_CLIENT_SECRET=您的客户端密钥
AZURE_SUBSCRIPTION_ID=您的订阅 ID

安装

前提条件

• Python 3.10+
• 具有适当权限的 Azure 订阅
• 具有资源读取访问权限的服务主体

设置

如果您喜欢使用 uv：

# 使用 uv 设置环境
uv venv
.venv\Scripts\activate  # 在 Windows 上
source .venv/bin/activate  # 在 macOS/Linux 上

# 安装依赖项
uv add mcp[cli] azure-identity python-dotenv azure-mgmt-resource aiohttp

# 运行服务器
uv run -m azure_resource_mcp_server

与 Claude Desktop 一起使用

要与 Claude Desktop 一起使用，请将以下内容添加到您的配置文件：

{
  "mcpServers": {
    "azure-resource": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
        "run",
        "-m",
        "azure_resource_mcp_server"
      ],
      "env": {
        "AZURE_TENANT_ID": "your-tenant-id",
        "AZURE_CLIENT_ID": "your-client-id",
        "AZURE_CLIENT_SECRET": "your-client-secret",
        "AZURE_SUBSCRIPTION_ID": "your-subscription-id"
      }
    }
  }
}