Cloudscope

io.github.alexpota由 GitHub 帳號 alexpota 發布v0.3.3更新於 Oct 24, 2026

Azure + GCP cost management: spending, forecasts, anomalies, budgets, idle resources, and tags.

概覽

AI 產生的概覽

唯讀的 MCP 伺服器,讓助理查詢 Azure 與 GCP 雲端成本:支出、預測、異常、預算、閒置資源與標籤。

可以做什麼
  • 分析支出:依服務、群組或區域彙總成本,依標籤統計成本,比較兩個期間,列出花費最高的資源,並合併多個 Azure 訂閱或 GCP 專案的成本
  • 監控:偵測支出異常,查看預算狀態與預估超支,並預測未來支出
  • 最佳化:列出成本最佳化建議,找出附成本估算的閒置資源,以及缺少標籤的資源
  • 查詢脈絡:目前日期與月份界線、Azure 訂閱清單、GCP 專案清單
  • 執行引導式報告提示詞,例如每月成本回顧、浪費稽核、成本暴增調查、高階主管摘要與分攤報告
適用情境
適合想讓助理回答 Azure 或 GCP 帳單問題、調查成本上升、稽核浪費或閒置資源,或定期產出成本回顧與分攤報告,而不必自行閱讀原始計費資料的情境。
執行需求
透過 npx 在本機執行(需要 Node.js)。Azure:已安裝並登入 Azure CLI(az login),並具備 Cost Management Reader 角色;可選設定 AZURE_SUBSCRIPTION_ID,或透過 AZURE_TENANT_ID、AZURE_CLIENT_ID 與 AZURE_CLIENT_SECRET 使用服務主體。GCP:已登入 gcloud 應用程式預設憑證,啟用 BigQuery 計費匯出,設定 GOOGLE_CLOUD_PROJECT 與 GCP_BILLING_TABLE,並具備 BigQuery Data Viewer 與 Job User 角色;可選 GCP_PROJECT_ID、GCP_BILLING_ACCOUNT_ID 與 GOOGLE_APPLICATION_CREDENTIALS。
安裝前請注意
此伺服器聲明為唯讀,無法建立、修改或刪除雲端資源。它使用你現有的 CLI 憑證,或服務主體密鑰(AZURE_CLIENT_SECRET)、服務帳戶金鑰檔案(GOOGLE_APPLICATION_CREDENTIALS)讀取雲端計費資料,請妥善保管這些憑證。GCP 的 BigQuery 查詢依掃描資料量計費(每月前 1 TiB 免費);說明稱典型查詢每次低於一美分。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Cloudscope,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

CloudScope MCP

Ask your AI about your cloud bill.

[npm version] [MCP Registry] [Node.js] [TypeScript] [License: MIT]

What you get

Ask once: "Give me this month's cost review" — and CloudScope runs the full workflow (spend, deltas, anomalies, idle resources, budgets, forecast) and hands back a decision-ready report, not raw numbers to interpret yourself:

TL;DR

Month-to-date Azure spend is $4,312 (May 1–29), tracking +11% vs April. The mover is App Service (+$280) — a new staging slot left running. 2 idle resources cost $94/month; prod-budget is at 78% with 2 days left. Top action: delete the orphaned managed disk → save $63/month.

Spend This Month

ServiceCost%
Virtual Machines$2,14049.6%
App Service$89020.6%
Storage$61214.2%
Redis Cache$4109.5%
Networking$2606.0%

vs Last Month

+$427 (+11%) overall. App Service +$280 drove most of it; everything else flat. → new staging-slot-2, created May 12, never torn down.

Idle & Wasted Resources

ResourceType$/month
orphaned-osdisk-01Managed Disk$63
old-lb-ipPublic IP$31

Budget Status

prod-budget — 78% used, $4,312 / $5,500, on track (2 days left).

Recommended Actions

  1. Delete orphaned-osdisk-01 (unattached 40 days) → $63/month
  2. Tear down staging-slot-2 if staging is idle → ~$280/month
  3. Release old-lb-ip (no binding) → $31/month

Illustrative example showing the report format. Run /cloudscope:monthly-cost-review against your own subscription for live numbers.

Install

Claude CodeCursorVS Code
claude mcp add cloudscope -- npx -y cloudscope-mcpInstallInstall

Azure is auto-detected from your az login session. GCP requires BigQuery billing export setup (see below).

Supported Providers

ProviderStatus
Azure✅ Supported
GCP✅ Supported
AWSUse AWS's official server

Prerequisites

Azure

  • Azure CLI installed and logged in (az login)
  • Cost Management Reader role on the subscription

GCP

  • gcloud CLI installed and logged in (gcloud auth application-default login)
  • Billing export to BigQuery enabled — this is a one-time manual setup step, not enabled by default (the detailed export is recommended for resource-level cost queries)
  • BigQuery Data Viewer + BigQuery Job User roles on the dataset project
  • Note: BigQuery on-demand queries cost $6.25 per TiB scanned (pricing). The first 1 TiB/month is free. Billing export tables are small — typical CloudScope queries cost <$0.01 each.

Configuration

Azure (zero-config)

CloudScope auto-detects your subscription from az login. Just add the server:

json
{  "mcpServers": {    "cloudscope": {      "command": "npx",      "args": ["-y", "cloudscope-mcp"]    }  }}

To target a specific subscription, add an env block:

json
{  "mcpServers": {    "cloudscope": {      "command": "npx",      "args": ["-y", "cloudscope-mcp"],      "env": {        "AZURE_SUBSCRIPTION_ID": "your-subscription-id"      }    }  }}
Advanced: Service Principal (CI/CD & automated environments)
VariableDescription
AZURE_TENANT_IDAzure AD tenant ID
AZURE_CLIENT_IDApp registration client ID
AZURE_CLIENT_SECRETApp registration client secret

Set these alongside AZURE_SUBSCRIPTION_ID in the env block above.

GCP

GCP requires a BigQuery billing export table. Find your table name in GCP Console > Billing > Billing export > BigQuery export.

json
{  "mcpServers": {    "cloudscope": {      "command": "npx",      "args": ["-y", "cloudscope-mcp"],      "env": {        "GOOGLE_CLOUD_PROJECT": "my-project",        "GCP_BILLING_TABLE": "my-project.my_dataset.gcp_billing_export_resource_v1_XXXXXX"      }    }  }}

Set GOOGLE_CLOUD_PROJECT to your GCP project ID. Override with GCP_PROJECT_ID if your billing dataset lives in a different project.

These variables apply only when using GCP; Azure-only users can skip them.

VariableDescriptionRequired
GOOGLE_CLOUD_PROJECTGCP project IDYes
GCP_BILLING_TABLEFully-qualified BigQuery table (project.dataset.table)Yes
GCP_PROJECT_IDOverride project ID if different from GOOGLE_CLOUD_PROJECTNo
GCP_BILLING_ACCOUNT_IDBilling account ID for budget monitoringNo
GOOGLE_APPLICATION_CREDENTIALSPath to service account JSON key fileNo

Both Providers

json
{  "mcpServers": {    "cloudscope": {      "command": "npx",      "args": ["-y", "cloudscope-mcp"],      "env": {        "AZURE_SUBSCRIPTION_ID": "your-subscription-id",        "GOOGLE_CLOUD_PROJECT": "my-project",        "GCP_BILLING_TABLE": "my-project.my_dataset.gcp_billing_export_resource_v1_XXXXXX"      }    }  }}

Azure is auto-detected from az login. Add AZURE_SUBSCRIPTION_ID to target a specific subscription.

Example Questions

  • "How much did Azure cost last month?"
  • "Show GCP spending by service for the last 7 days"
  • "Any cost anomalies this week on GCP?"
  • "What will Azure cost next month?"
  • "Show me cost optimization recommendations for GCP"
  • "Compare Azure and GCP costs across all projects and subscriptions"

Security

CloudScope is read-only. It cannot create, modify, or delete any cloud resources. Azure uses Cost Management Reader permissions. GCP uses BigQuery Data Viewer + Job User with no write access.

FAQ

Does this modify my cloud resources? No. Read-only access only.

Do I need a service principal? No. az login (Azure) or gcloud auth application-default login (GCP) works for local use.

Does the Azure Cost Management API cost money? No. It's free.

Do GCP BigQuery cost queries cost money? Yes, but typically <$0.01 per query ($6.25/TiB scanned, first 1 TiB/month free). See BigQuery pricing.

Can I use both Azure and GCP at the same time? Yes. Configure both sets of env vars and CloudScope queries whichever provider you specify in each tool call.

Development

bash
git clone https://github.com/alexpota/cloudscope-mcp.gitcd cloudscope-mcpnpm installnpm run buildnpm testnpx @modelcontextprotocol/inspector node dist/index.js

Reference

Tools

Most tools accept a provider parameter (azure or gcp); the provider-specific tools (list_subscriptions, list_projects, and the cross-account tools get_cross_subscription_costs / get_cross_project_costs) are fixed to their own cloud. The default provider is auto-detected based on which providers are configured.

Cost Analysis

ToolDescriptionKey Parameters
get_cost_summarySpending breakdown by service, group, or regionstart_date, end_date, group_by
get_cost_by_tagCosts grouped by a tag/label keytag_key, start_date, end_date
compare_periodsSide-by-side cost comparison of two date rangesperiod_a_start/end, period_b_start/end
top_spending_resourcesMost expensive individual resourcesdays, limit
get_cross_subscription_costsCombined costs across Azure subscriptionssubscription_ids, start_date, end_date
get_cross_project_costsCombined costs across GCP projectsproject_ids, start_date, end_date

Monitoring

ToolDescriptionKey Parameters
detect_anomaliesFind spending spikes vs previous perioddays, threshold
check_budgetsBudget status, current spend, projected overage(none)
get_cost_forecastPredict spending based on current trendsdays

Optimization

ToolDescriptionKey Parameters
list_recommendationsCost optimization suggestions (Azure Advisor / GCP Recommender)category
find_idle_resourcesProvisioned but unused resources with cost estimates(none)
find_untagged_resourcesResources with no tags/labels (cost attribution gaps)(none)

Utility

ToolDescriptionKey Parameters
get_current_dateToday's date and current/previous month bounds(none)
list_subscriptionsAzure subscriptions with active indicator(none)
list_projectsGCP projects with active indicator(none)

Prompts

Guided workflows that produce structured reports. All prompts accept an optional provider argument (azure or gcp). In Claude Code, type /cloudscope: to see all prompts. In Claude Desktop, click the + button → Connectors → cloudscope.

PromptDescriptionArguments
monthly-cost-reviewComplete monthly review: spending, last-month comparison, anomalies, top resources, budgets, forecast, savings opportunitiesprovider (optional)
waste-auditFind wasted spend: top resources, optimization recommendations, at-risk budgets, total potential savingsprovider (optional)
cost-spike-investigationRoot-cause analysis for a cost increase: which services, which resources, trend vs one-time, recommended actionsdays (optional), provider (optional)
executive-summaryBrief non-technical cost summary for leadership: spend, trend, budget status, top drivers, forecast, key recommendationprovider (optional)
chargeback-reportCost allocation by tag/label key for chargeback: spending per value, untagged resources, tagged vs untagged split, month-over-monthtag_key (required), provider (optional)

License

MIT

來源:README.md,提交 99a2a7a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.3.3最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分