CloudScope MCP

向您的 AI 询问您的云账单。

npm version Node.js TypeScript License: MIT

安装

Claude Code	Cursor	VS Code
`claude mcp add cloudscope -- npx -y cloudscope-mcp`	安装	安装

功能介绍

CloudScope 为 AI 助手提供对您的 Azure 成本数据的只读访问权限。通过自然语言询问支出情况、查找异常、获取优化建议并预测下个月的账单。

支持的提供商

提供商	状态
Azure	✅ 已支持
GCP	即将推出
AWS	使用 AWS 官方服务器

前置要求

已安装 Azure CLI 并已登录 (az login)
您的订阅 ID (az account show --query id -o tsv)
订阅上的 成本管理读取者 (Cost Management Reader) 角色

配置

添加到您的 MCP 客户端配置 (claude_desktop_config.json、Cursor 设置等)：

{
  "mcpServers": {
    "cloudscope": {
      "command": "npx",
      "args": ["-y", "cloudscope-mcp"],
      "env": {
        "AZURE_SUBSCRIPTION_ID": "your-subscription-id"
      }
    }
  }
}

本地开发无需服务主体。DefaultAzureCredential 会自动获取您的 az login 会话。

变量	描述
`AZURE_TENANT_ID`	Azure AD 租户 ID
`AZURE_CLIENT_ID`	应用注册客户端 ID
`AZURE_CLIENT_SECRET`	应用注册客户端密钥

在上述 env 块中与 AZURE_SUBSCRIPTION_ID 一起设置这些变量。

工具

工具	描述	关键参数
`get_cost_summary`	按服务、组或区域划分的支出明细	`start_date`, `end_date`, `group_by`
`detect_anomalies`	查找与上一周期相比的支出激增情况	`days`, `threshold`
`list_recommendations`	Azure Advisor 成本优化建议	`category`
`get_cost_forecast`	基于当前趋势预测支出	`days`
`check_budgets`	预算状态、当前支出、预计超支情况	(无)
`compare_periods`	两个日期范围的成本并排比较	`period_a_start/end`, `period_b_start/end`
`top_spending_resources`	最昂贵的单个资源	`days`, `limit`
`get_current_date`	今天日期及当前/上个月的边界	(无)

示例提示词

“上个月 Azure 花了多少钱？”
“显示过去 7 天按资源组划分的支出”
“本周有任何成本异常吗？”
“下个月 Azure 的费用是多少？”
“向我展示成本优化建议”
“哪些服务的支出增长最大？”

安全性

CloudScope 是只读的。它无法创建、修改或删除任何 Azure 资源。所有 API 调用均使用“成本管理读取者”权限，且没有写入权限。

常见问题

这会修改我的 Azure 资源吗？ 不会。仅限只读访问。

我需要服务主体吗？ 不需要。az login 适用于本地使用。

GCP 怎么样？ 即将推出。

Azure 成本管理 API 收费吗？ 不收费。它是免费的。

开发

git clone https://github.com/alexpota/cloudscope-mcp.git
cd cloudscope-mcp
npm install
npm run build
npm test
npx @modelcontextprotocol/inspector node dist/index.js