🧩 主要功能：它能帮你做什么？

azure-resource-lookup 的核心能力是让你用自然语言快速查找和盘点 Azure 资源。你可以问“列出我订阅里的所有虚拟机”、“显示存储账户”、“查找容器应用”，它会自动调用 Azure Resource Graph 执行查询并返回结果。

它支持跨订阅和跨资源组的查询。这意味着你不需要在门户里一个个切换订阅，直接一句话就能拿到全局视图。对于管理多个订阅的团队来说，这个功能省去了大量手动操作。

标签审计是另一个实用场景。你可以查找缺少必需标签的资源，或者按标签筛选特定项目、成本中心、环境类型的资源。孤立资源发现也很方便——它能找出未挂载的磁盘、未使用的网卡、空闲的公网 IP，这些资源往往在悄悄产生费用。

需要注意的是，App Service 和 Web Apps 没有专用的 MCP 列表命令，所以“列出网站”、“列出 Web 应用”这类请求必须通过这个技能走 Azure Resource Graph 查询。

⚙️ 第一次怎么安装？

安装方式取决于你使用的 AI 工具。这个技能包含在微软官方的 azure-skills 插件包里。

GitHub Copilot CLI 用户： 运行 /plugin marketplace add microsoft/azure-skills 添加市场，然后运行 /plugin install azure@azure-skills 完成安装。

VS Code 用户： 从 Visual Studio Marketplace 安装 Azure MCP 扩展。这个扩展会自动配置 Azure MCP Server 和完整的技能层。

Claude Code 用户： 运行 /plugin install azure@claude-plugins-official，或者在插件市场里搜索 “azure” 找到并安装。

Cursor 用户： 打开 Settings > Plugins，搜索 “Azure” 即可从 Cursor 市场安装。

安装前需要确保：你有一个 Azure 订阅；Node.js 已安装；Azure CLI（v2.60.0 或更高版本）已安装并完成 az login 登录。

🔧 怎么使用：MCP 工具与操作流程

azure-resource-lookup 通过 Azure MCP Server 与你的 AI 助手协作。当你的请求涉及单资源类型查询时，它会先检查是否有专用的 MCP 工具可以处理；如果没有，它会自动生成 Azure Resource Graph 查询来完成任务。

核心 MCP 工具：

extension_cli_generate —— 这是主入口工具。它根据你的意图生成 az graph query 命令，然后执行并返回结果。支持的查询语言是 KQL（Kusto Query Language 的子集）。

mcp_azure_mcp_subscription_list —— 列出你可用的订阅，帮助你在查询前确定作用范围。

mcp_azure_mcp_group_list —— 列出资源组，用于缩小查询范围。

使用流程：

第一步，检查专用工具。 对于单资源类型查询，插件会先看是否有现成的 MCP 工具。比如虚拟机有 compute 工具，存储账户有 storage 工具，Cosmos DB 有 cosmos 工具。如果有，直接用；如果没有（比如 App Service、Container Apps），就走 Resource Graph 查询。

第二步，生成 ARG 查询。 通过 extension_cli_generate 生成 az graph query 命令。比如你说“列出所有虚拟机”，它会生成类似 az graph query -q "Resources | where type =~ 'Microsoft.Compute/virtualMachines' | project name, location, resourceGroup" 的命令。

第三步，执行并格式化结果。 运行生成的命令，用 --query 参数（JMESPath）塑造输出格式，用 --first N 限制返回数量，用 --subscriptions 指定作用范围。

示例指令： “列出我订阅里的网站”、“显示我的 Web 应用”、“列出虚拟机”、“显示存储账户”、“查找容器应用”、“我有哪些资源？”、“按标签查找资源”、“显示孤立资源”、“按类型统计资源数量”。

🎯 主要应用场景

资源盘点。 接手新项目或做年度审计时，需要快速摸清订阅里到底跑了什么。用这个技能跑一遍，几分钟就能得到完整清单。

成本优化前置排查。 在找成本团队做优化之前，先用它找出孤立资源——那些未挂载的磁盘、未使用的网卡、空闲的 IP，这些往往是可以直接清理的浪费。

标签合规检查。 公司要求所有资源必须打上成本中心、环境类型等标签。用这个技能快速找出缺标签的资源，比手动一个个点开看快得多。

跨订阅查询。 管理多个订阅时，不需要逐个切换。一句话就能跨订阅查找特定类型的资源。

💡 使用技巧与隐藏玩法

技巧一：优先用专用工具。 如果你要查虚拟机、存储账户、Cosmos DB、AKS 这些有专用 MCP 工具的资源，直接用专用工具更高效。只有专用工具覆盖不到的资源（如 App Service、Container Apps）才走 Resource Graph。

技巧二：用 =~ 做大小写不敏感匹配。 KQL 里 == 是大小写敏感匹配，=~ 是大小写不敏感。查资源类型时用 =~ 更稳妥，避免因为大小写问题漏掉资源。

技巧三：用 --first N 限制结果数量。 大订阅里资源可能成千上万，不加限制会导致输出爆炸。用 --first 50 之类的参数控制返回条数。

技巧四：配合 azure-cost 做成本分析。 这个技能不做成本分析，但可以先用它找出孤立资源，再用 azure-cost 评估这些资源的成本影响。

技巧五：用标签做精细化筛选。 如果你的资源有规范的标签体系，可以用标签快速缩小查询范围。比如“查找环境标签为 production 的所有资源”。

🤖 适合哪些 AI 工具？

azure-resource-lookup 作为 azure-skills 插件包的一部分，支持多种 AI 工具。第一是 GitHub Copilot for Azure，包括 VS Code 里的 Copilot 代理模式和 Copilot CLI。

第二是 Claude Code，通过官方插件市场安装后即可使用。

第三是 Cursor，从 Cursor 插件市场安装 Azure 插件后即可调用。

此外，任何兼容 MCP 协议的客户端都可以通过 Azure MCP Server 连接使用。

📝 最后说一句

azure-resource-lookup 解决的是一个很基础但很耗时的问题：搞清楚 Azure 里到底有什么。它不会帮你部署或修改资源，但能让你在几秒钟内拿到以前需要点开十几个页面才能拼凑出的信息。对于任何需要管理 Azure 环境的团队来说，这都是一个值得装上的实用技能。