Azure Cost Management MCP

Azure成本管理MCP服务器

MCP（模型上下文协议）服务器，用于与 API 集成 Azure成本管理符合指导方针 WAF成本优化 e CAF（云采用框架） 微软。

兼容 GitHub Copilot 聊天助手, 克劳德桌面和任何MCP客户端。

______________________________________________________________________

索引

• 先决条件
• 安装
• Azure 身份验证
• IDE 配置

- - 克劳德桌面 - 光标 - 帆板运动

• 参考范围
• 可用工具

- 数据查询 - azure_cost_forecast - azure_cost_dimensions - 数据队列警报 - 数据块列表 - 数据块集合 - 数据块创建 - azure_budget_delete - azure_advisor推荐

• 在聊天中使用示例
• RBAC — 所需角色
• 代码架构
• 发展

______________________________________________________________________

先决条件

______________________________________________________________________

安装

cd azure-cost-management-mcp
npm install
npm run build

已编译的服务器将可在 dist/index.js.

______________________________________________________________________

Azure 身份验证

美国服务器 DefaultAzureCredential 从 SDK @azure/identity按顺序自动尝试以下模式：

选项 A — Azure CLI（本地开发，推荐）

az login
# oppure, per un tenant specifico:
az login --tenant 

不需要环境变量。服务器会自动检测 CLI 令牌。

选项 B — 主要服务（CI/CD、自动化）

设置以下环境变量（参见 .env.example):

AZURE_TENANT_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
AZURE_CLIENT_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
AZURE_CLIENT_SECRET=your-client-secret
AZURE_SUBSCRIPTION_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx  # default subscription

选项 C — Managed Identity（在 Azure 上托管的工作负载）

无配置 。 DefaultAzureCredential 自动检测通过 IMDS 管理的身份。

______________________________________________________________________

IDE 配置

VS Code+GitHub副驾驶聊天

Metodo 1--文件 .vscode/mcp.json 工作空间（推荐）

创建或编辑文件 /.vscode/mcp.json:

{
  "servers": {
    "azure-cost-management": {
      "type": "stdio",
      "command": "node",
      "args": ["${userHome}/azure-cost-management-mcp/dist/index.js"],
      "env": {
        "AZURE_SUBSCRIPTION_ID": "${env:AZURE_SUBSCRIPTION_ID}"
      }
    }
  }
}

它使用 az login，该部分 env 可能是空的—— DefaultAzureCredential 美国il代币CLI。 根据服务负责人aggiungi AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET.

方法 2 — VS 代码用户设置（全局）

四月 Ctrl+Shift+P → 首选项：打开用户设置（JSON） 并添加：

{
  "mcp.servers": {
    "azure-cost-management": {
      "type": "stdio",
      "command": "node",
      "args": ["C:/Users//azure-cost-management-mcp/dist/index.js"]
    }
  }
}

在VS代码中检查连接：

1. 打开面板 GitHub Copilot 聊天助手 (Ctrl+Alt+I)
2. 选择模式 代理 (@)
3. 请输入 ： @azure-cost-management qual è la spesa del mese corrente per la subscription xxx?

______________________________________________________________________

克劳德桌面

编辑 Claude Desktop 配置文件：

• 窗户： %APPDATA%\Claude\claude_desktop_config.json
• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "azure-cost-management": {
      "command": "node",
      "args": ["C:/Users//azure-cost-management-mcp/dist/index.js"],
      "env": {
        "AZURE_SUBSCRIPTION_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      }
    }
  }
}

修改后重新启动 Claude Desktop。

______________________________________________________________________

光标

创建或修改 .cursor/mcp.json 在用户主页或项目文件夹中：

{
  "mcpServers": {
    "azure-cost-management": {
      "command": "node",
      "args": ["C:/Users//azure-cost-management-mcp/dist/index.js"],
      "env": {
        "AZURE_SUBSCRIPTION_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      }
    }
  }
}

______________________________________________________________________

帆板运动

修改 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "azure-cost-management": {
      "command": "node",
      "args": ["C:/Users//azure-cost-management-mcp/dist/index.js"],
      "env": {
        "AZURE_SUBSCRIPTION_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      }
    }
  }
}

______________________________________________________________________

参考范围

所有工具都接受一个参数 scope 确定要操作的 Azure 级别。

CAF提示： 美国 mg: 用于对所有着陆区进行跨订阅分析，而无需对每个订阅单独迭代。

______________________________________________________________________

可用工具

azure_cost_query

查询具有分组和时间过滤器的 Azure 范围的实际成本或折旧成本。

参数 ：

共同的价值观 groupBy:

ResourceGroup       ServiceName         ResourceType
Location            SubscriptionName    MeterCategory
MeterSubCategory    ChargeType
tag:CostCenter      tag:Environment     tag:Application

______________________________________________________________________

azure_cost_forecast

根据当前使用趋势返回支出预测。

参数 ：

______________________________________________________________________

azure_cost_dimensions

列出在指定范围内可用的分组和过滤器大小。在使用之前 azure_cost_query 找出有效的值 groupBy.

参数 ：

______________________________________________________________________

azure_cost_alerts

列出一个范围的活动成本警报：预算压力，信用警报，违反配额，异常。

参数 ：

答案 — 主要字段：

{
  "total": 2,
  "active": 1,
  "alerts": [
    {
      "name": "alert-xxx",
      "definitionType": "Budget",
      "definitionCategory": "Cost",
      "status": "Active",
      "creationTime": "2024-01-15T10:30:00Z"
    }
  ]
}

______________________________________________________________________

azure_budget_list

列出范围内的所有成本预算，包括当前支出、门槛和状态。

参数 ：

现场可能的状态 status:

______________________________________________________________________

azure_budget_get

检索特定预算的完整详细信息：当前支出，预计支出，通知门槛和过滤器。

参数 ：

______________________________________________________________________

azure_budget_create

使用 WAF 推荐的警报门槛创建或更新成本预算。如果在同一范围内已经存在具有相同名称的预算，则将更新。

参数 ：

______________________________________________________________________

azure_budget_delete

永久删除预算。 手术是不可逆的。

参数 ：

______________________________________________________________________

azure_advisor_recommendations

获取 Azure Advisor 关于成本优化类别的建议。

涵盖：缩放未使用的 VM，消除闲置资源（未连接磁盘，未使用的公共 IP），购买预留实例或节省计划以实现可预测的工作负载。

参数 ：

注： Azure Advisor 仅在订阅级别上运行。范围 mg: 不支持此工具。

______________________________________________________________________

在聊天中使用示例

这些示例适用于 GitHub Copilot Chat 和 Claude Desktop、Cursor 和 Windsurf。

当前支出分析

Mostrami la spesa del mese corrente per la subscription aaaa-bbbb-cccc,
raggruppata per ServiceName e ordinata per costo decrescente.

Qual è la spesa degli ultimi 3 mesi raggruppata per ResourceGroup?
Usa il periodo Custom da 2024-01-01 a 2024-03-31 con granularità Monthly.

Mostrami la ripartizione dei costi per tag:CostCenter e tag:Environment
nella subscription aaaa — voglio fare il chargeback ai team.

预测和异常

Prevedi la spesa di marzo per la subscription aaaa.
Poi confronta con il budget esistente per capire se siamo a rischio sforamento.

Ci sono alert di costo attivi nella subscription aaaa?

预算管理

Elenca tutti i budget nella subscription aaaa con il loro stato attuale.

Crea un budget mensile da 5000 EUR per il resource group "prod-rg"
nella subscription aaaa, con notifiche a mario@example.com.

Il budget "monthly-prod" nella subscription aaaa è stato superato?
Mostrami i dettagli e la spesa prevista per fine mese.

成本优化（WAF/CAF）

Quali sono le raccomandazioni di Azure Advisor ad alto impatto
per la subscription aaaa? Voglio massimizzare i risparmi.

Fai un'analisi completa dei costi per il management group "my-mg":
spesa corrente per subscription, alert attivi, e raccomandazioni Advisor.

Quali dimensioni sono disponibili per il raggruppamento dei costi
nella subscription aaaa? Voglio capire su quali tag posso fare showback.

______________________________________________________________________

RBAC — 所需角色

将角色分配给适当的范围（订阅、资源组或管理组）：

Advisor的建议。 读者 （订阅级别）

CAF企业： 分配角色级别 管理小组 以单一分配覆盖所有登陆区订阅。

# Esempio: assegnare Cost Management Reader al management group
az role assignment create \
  --role "Cost Management Reader" \
  --assignee  \
  --scope /providers/Microsoft.Management/managementGroups/

______________________________________________________________________

代码架构

azure-cost-management-mcp/
├── src/
│   ├── index.ts              # Entry point MCP server, registrazione tool
│   ├── client.ts             # Client Azure singleton + helper scope/risposta
│   ├── tools/
│   │   ├── cost.ts           # azure_cost_query, forecast, dimensions, alerts
│   │   ├── budgets.ts        # azure_budget_list/get/create/delete
│   │   └── advisor.ts        # azure_advisor_recommendations
│   └── __tests__/
│       ├── client.test.ts    # Unit test: normalizeScope, transformRows, ecc.
│       └── server.integration.test.ts  # Integration test: protocollo MCP
├── dist/                     # Output compilato TypeScript (generato da npm run build)
├── package.json
├── tsconfig.json
└── .env.example

主要依赖关系：

建筑流程：

GitHub Copilot / Claude / Cursor
         │ MCP (stdio)
         ▼
    src/index.ts  (McpServer + StdioServerTransport)
         │
    src/client.ts  (DefaultAzureCredential, singleton client, normalizeScope)
         │
    ┌────┼────────────────────┐
    ▼    ▼                    ▼
Azure Cost    Azure           Azure
Management    Consumption     Advisor
API           API (Budgets)   API

______________________________________________________________________

发展

# Avvia in watch mode (rebuild automatico al salvataggio)
npm run dev

# Verifica tipi senza compilare
npm run typecheck

# Build di produzione
npm run build

# Avvia il server compilato
npm start

# Esegui tutti i test (unit + integration)
npm test

# Solo unit test (client utilities)
npm run test:unit

# Solo integration test (protocollo MCP)
npm run test:integration

快速测试服务器：

# Verifica che il server si avvii e risponda al protocollo MCP
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' \
  | node dist/index.js

注册工具列表：

(
  echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
  echo '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
) | node dist/index.js