azure-mcp 快速入门

让 AI 直接管 Azure——3 步接入微软官方 MCP Server,132 个工具覆盖存储、计算、AI、监控。

这是什么?解决什么问题?

azure-mcp 是微软 Azure 团队在 Azure/azure-mcp 仓库下开源的 Model Context Protocol Server,把 Azure 全家桶的 132 个核心操作(数量会随版本变化)统一暴露给 AI 编程 Agent,涵盖:

• 存储:Blob Storage、File Share、Queue、Table、Cosmos DB;
• 计算:Virtual Machines、App Service、Functions、AKS、Container Apps;
• 数据库:Azure SQL、PostgreSQL、MySQL、Cosmos DB;
• 网络:Virtual Network、Load Balancer、Application Gateway、Front Door;
• AI/ML:Azure OpenAI、Cognitive Services、ML Studio、Document Intelligence;
• 监控:Log Analytics、Application Insights、Monitor Metrics;
• 身份:Entra ID(Azure AD)、RBAC、Managed Identity;
• DevOps:Azure DevOps、Pipelines、Artifacts;
• 密钥:Key Vault、机密轮换。

普通开发者想用 AI 操作 Azure 时,通常要写一堆 az CLI、ARM Template、bicep,或者在 Azure Portal 上点点点。azure-mcp 把这些操作封装成 MCP 工具,Agent 可以用自然语言方式让你“创建 VM / 查 metrics / 改 RBAC / 调 OpenAI”。

适合云架构师、DevOps、SRE、Azure 开发者、AI 工程师,以及任何“想让 AI 帮我管云”的工程师。

准备工作

1. Azure 账号:免费注册即可拿到 $200 试用金。
2. Azure CLI ≥ 2.50:az --version 检查,brew install azure-cli 或 winget install Microsoft.AzureCLI。
3. AI 编程 Agent:Claude Code 体验最完整(原生支持 MCP),Cursor 次之。
4. Node.js ≥ 18 或 .NET 8:本 Skill 同时提供两套 server。
5. Azure 订阅 ID:在 Portal → Subscriptions 里复制。

3 步快速上手

第 1 步:登录 Azure

az login
# 浏览器跳出登录,选好订阅后:
az account show --query id -o tsv

记录下 subscription id。

第 2 步:启动 azure-mcp Server

方式 A:NPM 全局安装

npm install -g @azure/mcp

方式 B:从源码跑

git clone https://github.com/Azure/azure-mcp.git
cd azure-mcp
dotnet run --project src/AzureMcp

第 3 步:在 Claude Code 中配置 MCP

编辑 ~/.claude/mcp.json:

{
  "mcpServers": {
    "azure": {
      "command": "azure-mcp",
      "env": {
        "AZURE_SUBSCRIPTION_ID": "<your-subscription-id>",
        "AZURE_TENANT_ID": "<your-tenant-id>"
      }
    }
  }
}

重启 Claude Code,输入 /mcp,应当看到 azure 工具集,包含 132 个工具。

第 4 步(实战):用 Skill 跑第一个任务

帮我做这些事,用 azure-mcp:

1. 列出我当前订阅里所有 resource group;
2. 在 rg-demo 里创建一个 storage account,名称 stmytest202606,SKU Standard_LRS;
3. 给这个 storage account 创建一个 container,名字 images;
4. 上传本地 ./photo.jpg 到 container;
5. 生成 24 小时有效的 SAS URL。

Agent 会自动按顺序调用:

1. resource_group_list;
2. storage_account_create;
3. blob_container_create;
4. blob_upload;
5. blob_sas_generate。

常见踩坑

1. 没 az login 就跑:MCP server 需要 Azure 凭据,az login 是最简方式。
2. subscription id 没设:Agent 会在 132 个工具中迷失,Skill 提示必须在 env 里固定。
3. 权限不足:Contributor 角色起步,只读任务可以用 Reader。Skill 提示主动报 “需要角色 X”。
4. 区域写错:Azure 资源创建必须选 region,Skill 提示 Agent 先反问 eastus / japaneast / chinaeast2 等。
5. 资源名长度限制:Storage Account 只能 3-24 位小写字母数字,Skill 提示 Agent 自动校验。
6. 大对象上传超时:超过 100MB 用 azcopy 而不是 MCP,Skill 提示根据 size 选工具。

初级用法

1. 查资源清单

列出我 rg-prod 里所有 Storage Account 的名称和 region。

2. 创建 Web App

在 rg-prod 里创建一个 Linux App Service,plan 是 B1,跑 Node 20 镜像,GitHub 部署源。

3. 拉 metrics

查 my-vm 过去 1 小时的 CPU 平均使用率,粒度 5 分钟。

高级玩法

1. 自动化资源清理

找出订阅里所有 tags 为 env:dev 且 30 天无活动的资源,生成清理计划(不实际执行)。

2. AI 助手管 AKS

帮我看 aks-prod 集群的 node 状态,如果 NotReady 的超过 2 个就告警。

3. 与 Azure DevOps 联动

创建一个 Azure DevOps Pipeline,build 一个 Node 项目,部署到刚创建的 App Service。

4. 用 Bicep 生成 IaC

把刚才我创建的所有资源,生成对应的 Bicep 模板,放进 infra/main.bicep。

小技巧

• --no-wait 模式:大规模部署别让 MCP 阻塞,后台运行 + 轮询。
• 善用 Tag:Skill 强调每次创建资源都加 env / owner / cost-center,方便管理。
• Managed Identity 优先:不要用 connection string,把 enableManagedIdentity: true 加到所有 PaaS。
• 配额(quota)检查:创建 VM 前先 vm_skus_list 查可用 SKU,避免 quota 报错。
• Cost optimization:Skill 提示定期跑 advisor_recommendation_list 看省钱建议。

常见问题 FAQ

Q1: 这个 Skill 跟 azure-mcp 有什么关系?必须装吗?

A: Skill 是给 AI Agent 用的”技能包”,能告诉 Agent 怎么按特定规范工作。不是必须装——如果你的项目规模小、要求不高,不装也能用。但装上能让 Agent 输出的质量更高、更符合最佳实践,推荐装。

Q2: 这个 Skill 适合哪些 AI Agent?Cursor?Claude Code?其他?

A: azure-mcp 来自 community,主要面向支持 Skill 机制的 Agent。常见兼容 Agent 包括 Claude Code、Cursor、OpenCode、Windsurf 等。具体兼容性请查 Skill 官方文档。

Q3: 装了这个 Skill 后,会拖慢 Agent 响应吗?

A: 会的——Skill 通常会增加 prompt 长度,导致响应变慢、token 消耗增加。但质量提升明显。建议:1) 只装项目必需的 Skill;2) 用 Skill 启动/加载/卸载机制按需加载;3) 定期清理不用的 Skill。

Q4: 怎么验证 Skill 装对了?

A: 在 Agent 中输入”列出已加载的 Skill”或类似命令。如果 Skill 出现在列表里,说明装对了。然后用 Skill 跑一个相关任务,看输出是否符合 Skill 规范。

Q5: 这个 Skill 有许可证吗?能商用吗?

A: 取决于 azure-mcp 的许可证。常见许可证包括 MIT(完全自由)、Apache-2.0(自由但有专利条款)、源可用(可看不能用)、GPL(强开源)。商用前请查仓库 LICENSE 文件。

进阶学习建议

如果想进一步用好 azure-mcp,建议按以下路径学习:

第 1 周:熟练使用

• 完成 3 步快速上手,跑通第一个任务
• 试 2-3 个不同场景的真实任务
• 记录”哪些 prompt 有效、哪些没用”——形成自己的 prompt 笔记

第 2 周:理解机制

• 阅读 Skill 的官方文档(README、SKILL.md)
• 了解 Skill 的”触发关键词”和”输出格式”
• 学习”如何用更具体的描述触发 Skill”

第 3-4 周:组合使用

• 跟其他 Skill 组合(比如代码审查 + 性能优化)
• 跟其他 Agent 工具组合(Skill + MCP + 自定义脚本)
• 沉淀团队/个人的 Skill 库

长期:贡献社区

• 把自定义的 Skill 开源到 GitHub
• 提 PR 改进现有 Skill
• 写使用心得分享到 CSDN/掘金/知乎

推荐资源:

• 官方文档:https://github.com/Azure/azure-mcp
• 官方仓库 README 里的 Examples
• 社区最佳实践:Anthropic 官方博客 https://www.anthropic.com/blog
• 国内社区:CSDN AI 板块、掘金 AI 板块

避免的坑:

• 不要装太多 Skill(超过 10 个会拖慢 Agent)
• 不要把 Skill 装在不兼容的 Agent 上
• 不要直接复制 Skill 默认 prompt——要根据项目调整
• 定期 review Skill 库的实用性,清理不用的

参考链接

• azure-mcp 仓库:https://github.com/Azure/azure-mcp
• Azure MCP 官方文档:https://learn.microsoft.com/en-us/azure/developer/azure-mcp/overview
• Azure CLI 安装:https://learn.microsoft.com/en-us/cli/azure/install-azure-cli
• Model Context Protocol 规范:https://modelcontextprotocol.io/
• Azure SDK for .NET:https://learn.microsoft.com/en-us/dotnet/azure/
• Azure 试用注册:https://azure.microsoft.com/free/
• Azure Pricing 计算器:https://azure.microsoft.com/pricing/calculator/
• Azure Well-Architected Framework:https://learn.microsoft.com/en-us/azure/well-architected/
• Bicep 文档:https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/overview

我的个人推荐(测试编辑 Mnet)

最常用的 1 个核心用法:每天打开 Agent 第一时间加载这个 Skill,既不消耗太多 token 也能规范输出。

最容易踩的坑:别把 Skill 提示词当”开箱即用”的最终答案——它只是给你一个”标准框架”,具体项目还得你自己调整。

适合人群:做过 3+ 个实际项目的开发者,而不是”看一遍文档就完事”的小白。

3 个月使用心得:刚开始用时觉得”规范是约束”,用了 3 个月后才发现”规范是省时间”——避免每次重新决策同样的细节。

推荐配合的工具:Claude Code / Cursor / OpenCode 任选一个主流 Agent 即可,不要在工具选择上纠结太久。

长期价值:这类 Skill 的核心价值不是”立竿见影的输出”,而是”持续一致的质量”——长期用下来,你的项目质量会稳定在专业水平。

本文基于官方文档和公开资料整理，AI辅助生成，MagicNetWorld 尚未完成独立实测。如有错误或过时信息，请通过 contact@magicnetworld.com 反馈。