Skip to main content
Glama
cloudscope-mcp

cloudscope-mcp

by alexpota

CloudScope MCP

AIにクラウド料金について質問できます。

npm version Node.js TypeScript License: MIT

インストール

Claude Code

Cursor

VS Code

claude mcp add cloudscope -- npx -y cloudscope-mcp

インストール

インストール

Related MCP server: Azure FinOps Elite

機能

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

2つの期間のコストを並べて比較

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 Cost Management 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

ライセンス

MIT

Available Tools

15 tools
check_budgetsBudget StatusA
Read-onlyIdempotent

Check budget status: current spend vs limit, percentage used, forecast, and overage risk. For GCP, requires GCP_BILLING_ACCOUNT_ID to be set.

Inputs: provider.

compare_periodsCompare Cost PeriodsA
Read-onlyIdempotent

Compare costs between two date ranges, showing per-service absolute and percentage changes.

Inputs: period_a_start (required), period_a_end (required), period_b_start (required), period_b_end (required), +2 more.

detect_anomaliesDetect Cost AnomaliesA
Read-onlyIdempotent

Compares daily spending over the last N days against the prior N days to find cost spikes. Returns a list of services where spending increased above the threshold percentage, sorted by increase amount. Each entry includes service name, previous cost, current cost, percentage change, and absolute change in USD. Returns an empty list if no anomalies found. Use this when the user asks about unexpected cost increases, billing surprises, or wants to know if anything changed recently.

Inputs: provider, days, threshold.

find_idle_resourcesFind Idle ResourcesA
Read-onlyIdempotent

Finds cloud resources that are provisioned but not actively used — unattached disks, orphaned network interfaces, unused IPs, idle VMs, and empty compute plans. Returns each resource with its name, type, resource group/project, reason it is idle, and estimated monthly cost in USD. Returns an empty list if no idle resources are found. Use this when the user asks about waste, idle or unused resources, cleanup opportunities, or wants to find resources to delete to reduce costs.

Inputs: provider.

find_untagged_resourcesFind Untagged ResourcesA
Read-onlyIdempotent

Finds resources that have no tags or labels applied. Returns each resource with its name, type, resource group/project, and location. Untagged resources cannot be attributed to teams or projects, making cost allocation and chargeback impossible. Returns an empty list if all resources are tagged. Use this when the user asks about tagging compliance, governance, cost attribution gaps, or wants to identify resources that need tags or labels.

Inputs: provider.

get_cost_by_tagCost by TagA
Read-onlyIdempotent

Breaks down costs by a specific tag or label key such as team, environment, or project. Returns a sorted table with each tag value, cost in USD, and percentage of total. Includes a total row and daily average. Returns an error if the date range is invalid or no tagged costs exist. Use this when the user asks about costs per team, per environment, cost allocation, chargeback, or wants to understand spending by any custom tag or label.

Inputs: tag_key (required), provider, start_date, end_date.

get_cost_forecastCost ForecastA
Read-onlyIdempotent

Projects future cloud spending for the next N days using a linear trend based on the last 30 days of actual costs. Returns the forecast period dates, projected total cost in USD, average daily projected cost, and the confidence basis (number of historical days used). Use this when the user asks "how much will I spend this month", wants to predict upcoming bills, or needs to plan budgets. Returns an error if insufficient historical data exists.

Inputs: provider, days.

get_cost_summaryCloud Cost SummaryA
Read-onlyIdempotent

Returns a cost breakdown for a date range grouped by service, resource group, tag, or region. Defaults to current month if dates are omitted. Output includes a sorted table with each group name, cost in USD, and percentage of total. Includes a total row, daily average, and collapses groups beyond the top 10 into an "Other" row. Returns an error if the date range is invalid. Use this when the user asks "how much am I spending", "what costs the most", "show me my cloud bill", or wants a spending overview.

Inputs: provider, start_date, end_date, group_by.

get_cross_project_costsCross-Project Cost SummaryA
Read-onlyIdempotent

Returns a combined cost breakdown across multiple GCP projects sorted by total spend. Each project shows its name, total cost in USD, and percentage of the combined total. Use this when the user asks about costs across all GCP projects, wants to compare project spending, or needs an organization-wide cost overview.

Inputs: provider (required), project_ids, start_date, end_date.

get_cross_subscription_costsCross-Subscription Cost SummaryA
Read-onlyIdempotent

Returns a combined cost breakdown across multiple Azure subscriptions sorted by total spend. Each subscription shows its name, total cost in USD, and percentage of the combined total. Handles partial failures gracefully — if some subscriptions are inaccessible, returns results for the rest with a warning. Use this when the user asks about costs across all subscriptions, wants to compare subscription spending, or needs an organization-wide cost overview.

Inputs: provider (required), subscription_ids, start_date, end_date.

get_current_dateCurrent DateA
Read-onlyIdempotent

Returns today's date and the start/end of current and previous months in YYYY-MM-DD format

Inputs: no named parameters.

list_projectsList GCP ProjectsA
Read-onlyIdempotent

Returns all GCP projects the current credential can access, with name, ID, and state. Shows which project is currently active. Use this when the user has multiple GCP projects and wants to see which ones are available, or before calling get_cross_project_costs.

Inputs: provider (required).

list_recommendationsCost Optimization RecommendationsA
Read-onlyIdempotent

Fetches cost-saving recommendations filtered by category. Returns a list of recommendations each containing: title, category, impact level (high/medium/low), estimated annual savings in USD, affected resource ID, and a short description of the suggested action. Returns an empty list if no recommendations exist for the selected category. Use this when the user wants to reduce costs, find waste, or optimize resource usage.

Inputs: provider, category.

list_subscriptionsList Azure SubscriptionsA
Read-onlyIdempotent

Returns all Azure subscriptions the current credential can access, with name, ID, and state. Shows which subscription is currently active. Use this when the user has multiple subscriptions and wants to see which ones are available, or to confirm which subscription is being queried.

Inputs: provider (required).

top_spending_resourcesTop Spending ResourcesA
Read-onlyIdempotent

Find the N most expensive individual resources over a time period. On GCP, requires the detailed billing export for resource-level data.

Inputs: provider, days, limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 15 tools

    Disambiguation4/5

    Most tools are clearly distinct by their focus (cost summary, tag breakdown, cross-project, anomalies, etc.). A minor potential confusion exists between get_cost_summary and get_cost_by_tag, but descriptions clarify the grouping dimension.

    Naming Consistency4/5

    The majority of tools follow a verb_noun pattern (check_, compare_, detect_, find_, get_, list_). The exception is 'top_spending_resources' which uses a less standard verb form, but overall the pattern is consistent.

    Tool Count5/5

    15 tools is well-scoped for a cloud cost management server, covering summary, breakdowns, forecasts, anomalies, optimization, and utilities without being overwhelming.

    Completeness4/5

    Core workflows are covered: cost review, forecast, anomalies, recommendations, and resource waste detection. Missing are write operations like budget creation or tagging, but the server appears read-only and covers its intended domain well.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      An MCP server for unified cost tracking and analysis across AWS, OpenAI, and Anthropic. It enables users to query expenditures, compare costs across providers, and analyze usage trends through natural language.
      10
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Production-grade MCP server for enterprise Azure cost optimization, enabling spend anomaly detection, multi-tenant auditing, budget validation, and compliance-aware recommendations.
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Local-first FinOps MCP server. Ask about your AWS, Azure, GCP, and SaaS costs in plain English. Anomaly detection, rightsizing, idle-resource cleanup, and Jira/Linear ticketing. Credentials never leave your machine.
      10
      20
      Apache 2.0