CloudScope MCP

CloudScope MCP

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

利用できる機能

**「今月のコストレビューをまとめて」**と一度依頼するだけで、CloudScope が支出、増減、異常、アイドル状態のリソース、予算、予測を含むワークフロー全体を実行し、解釈が必要な生の数値ではなく、意思決定にすぐ役立つレポートを返します。

TL;DR

5月1日〜29日の Azure の月初来支出は $4,312 で、4月比 +11% のペースです。 増加の要因は App Service（+$280） です。新しいステージングスロットが起動したままになっています。 2つのアイドル状態のリソースに月額$94かかっています。残り2日で prod-budget は 78% に達しています。 最優先のアクション：孤立したマネージドディスクを削除 → 月額$63を節約。

今月の支出

サービス	コスト	%
Virtual Machines	$2,140	49.6%
App Service	$890	20.6%
Storage	$612	14.2%
Redis Cache	$410	9.5%
Networking	$260	6.0%

先月との比較

全体で +$427（+11%） です。その大半は App Service の +$280 によるもので、他は横ばいです。→ 新しい staging-slot-2 は5月12日に作成され、削除されずに残っています。

アイドル状態・無駄なリソース

リソース	種類	$/月
orphaned-osdisk-01	マネージドディスク	$63
old-lb-ip	パブリック IP	$31

予算の状況

prod-budget — 78%使用済み、$4,312 / $5,500、予定どおり（残り2日）。

推奨アクション

1. orphaned-osdisk-01 を削除する（40日間未接続）→ 月額$63
2. ステージングがアイドル状態なら staging-slot-2 を停止する → 月額約$280
3. old-lb-ip を解放する（関連付けなし）→ 月額$31

レポート形式を示すための例です。ご自身のサブスクリプションで /cloudscope:monthly-cost-review を実行すると、最新の数値を確認できます。

インストール

Claude Code	Cursor	VS Code
claude mcp add cloudscope -- npx -y cloudscope-mcp	インストール	インストール

Azure は az login セッションから自動検出されます。GCP では BigQuery の請求エクスポートの設定が必要です（以下を参照）。

対応プロバイダー

プロバイダー	状態
Azure	✅ 対応済み
GCP	✅ 対応済み
AWS	AWS の公式サーバーを使用してください

前提条件

Azure

• Azure CLIをインストールし、ログインしていること（az login）
• サブスクリプションに対する Cost Management Reader ロール

GCP

• gcloud CLIをインストールし、ログインしていること（gcloud auth application-default login）
• BigQuery への課金データのエクスポートを有効にしていること — これはデフォルトでは有効になっていないため、一度だけ手動で設定する必要があります（リソースレベルのコストクエリには詳細エクスポートを推奨します）
• データセットのプロジェクトに対する BigQuery Data Viewer ＋ BigQuery Job User ロール
• 注：BigQuery のオンデマンドクエリでは、スキャンしたデータ 1 TiB あたり $6.25 の料金が発生します（料金）。最初の 1 TiB／月は無料です。課金エクスポートテーブルは小さいため、CloudScope の一般的なクエリの料金は 1 件あたり $0.01 未満です。

設定

Azure（設定不要）

CloudScope は az login からサブスクリプションを自動検出します。サーバーを追加するだけです。

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

特定のサブスクリプションを対象にするには、env ブロックを追加します。

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

詳細設定：サービスプリンシパル（CI/CD および自動化環境）

変数	説明
AZURE_TENANT_ID	Azure AD テナント ID
AZURE_CLIENT_ID	アプリ登録のクライアント ID
AZURE_CLIENT_SECRET	アプリ登録のクライアントシークレット

上記の env ブロックで、これらを AZURE_SUBSCRIPTION_ID とともに設定します。

GCP

GCP では BigQuery の課金エクスポートテーブルが必要です。テーブル名は GCP Console > Billing > Billing export > BigQuery export で確認できます。

{
  "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"
      }
    }
  }
}

GOOGLE_CLOUD_PROJECT に GCP プロジェクト ID を設定します。課金データセットが別のプロジェクトにある場合は、GCP_PROJECT_ID で上書きします。

これらの変数は GCP を使用する場合にのみ適用されます。Azure のみを使用するユーザーは設定を省略できます。

変数	説明	必須
GOOGLE_CLOUD_PROJECT	GCP プロジェクト ID	はい
GCP_BILLING_TABLE	完全修飾 BigQuery テーブル（project.dataset.table）	はい
GCP_PROJECT_ID	GOOGLE_CLOUD_PROJECT と異なる場合にプロジェクト ID を上書き	いいえ
GCP_BILLING_ACCOUNT_ID	予算のモニタリングに使用する課金アカウント ID	いいえ
GOOGLE_APPLICATION_CREDENTIALS	サービスアカウントの 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 は az login から自動検出されます。特定のサブスクリプションを対象にするには、AZURE_SUBSCRIPTION_ID を追加します。

質問例

• 「先月の Azure の料金はいくらでしたか？」
• 「過去 7 日間の GCP のサービス別支出を表示してください」
• 「今週、GCP でコストの異常はありましたか？」
• 「来月の Azure の料金はいくらになりますか？」
• 「GCP のコスト最適化に関する推奨事項を表示してください」
• 「すべてのプロジェクトとサブスクリプションにわたって、Azure と GCP のコストを比較してください」

セキュリティ

CloudScope は読み取り専用です。クラウドリソースの作成、変更、削除はできません。Azure では Cost Management Reader の権限を使用します。GCP では書き込みアクセス権のない BigQuery Data Viewer と BigQuery Job User を使用します。

FAQ

クラウドリソースは変更されますか？ いいえ。読み取り専用アクセスのみです。

サービスプリンシパルは必要ですか？ いいえ。ローカルでの使用には、az login（Azure）または gcloud auth application-default login（GCP）を使用できます。

Azure Cost Management API の利用には料金がかかりますか？ いいえ。無料です。

GCP BigQuery のコストクエリには料金がかかりますか？ はい。ただし、通常はクエリあたり $0.01 未満です（スキャンした TiB あたり $6.25、最初の 1 TiB/月は無料）。BigQuery の料金をご覧ください。

Azure と GCP の両方を同時に使用できますか？ はい。両方の環境変数を設定すると、CloudScope は各ツール呼び出しで指定されたプロバイダーに対してクエリを実行します。

開発

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

リファレンス

ツール

ほとんどのツールでは provider パラメーター（azure または gcp）を指定できます。プロバイダー固有のツール（list_subscriptions、list_projects、およびクロスアカウントツールの get_cross_subscription_costs／get_cross_project_costs）は、それぞれのクラウドに固定されています。デフォルトのプロバイダーは、設定されているプロバイダーに基づいて自動検出されます。

コスト分析

ツール	説明	主なパラメーター
get_cost_summary	サービス、グループ、またはリージョン別の支出内訳	start_date、end_date、group_by
get_cost_by_tag	タグ／ラベルキーごとに集計したコスト	tag_key、start_date、end_date
compare_periods	2 つの日付範囲のコストを並べて比較	period_a_start/end、period_b_start/end
top_spending_resources	コストが最も高い個々のリソース	days、limit
get_cross_subscription_costs	Azure サブスクリプション全体の合計コスト	subscription_ids、start_date、end_date
get_cross_project_costs	GCP プロジェクト全体の合計コスト	project_ids、start_date、end_date

モニタリング

ツール	説明	主なパラメーター
detect_anomalies	前の期間と比べた支出の急増を検出	days、threshold
check_budgets	予算状況、現在の支出、超過予測	(none)
get_cost_forecast	現在の傾向に基づいて支出を予測	days

最適化

ツール	説明	主なパラメーター
list_recommendations	コスト最適化の提案（Azure Advisor／GCP Recommender）	category
find_idle_resources	プロビジョニング済みだが未使用のリソースとコスト見積もり	(none)
find_untagged_resources	タグ／ラベルがないリソース（コスト配賦の漏れ）	(none)

ユーティリティ

ツール	説明	主なパラメーター
get_current_date	今日の日付と、当月／前月の期間	(none)
list_subscriptions	アクティブ状態の表示を含む Azure サブスクリプション	(none)
list_projects	アクティブ状態の表示を含む GCP プロジェクト	(none)

プロンプト

構造化されたレポートを作成する、ガイド付きのワークフローです。すべてのプロンプトは、任意の provider 引数（azure または gcp）を受け取ります。Claude Codeで /cloudscope: と入力すると、すべてのプロンプトが表示されます。Claude Desktopでは、+ ボタンをクリックして、コネクタ → cloudscope の順に選択します。

プロンプト	説明	引数
monthly-cost-review	月次レビュー全般：支出、先月との比較、異常、上位リソース、予算、予測、節約の機会	provider（任意）
waste-audit	無駄な支出を特定：上位リソース、最適化の推奨事項、超過リスクのある予算、節約可能な金額の合計	provider（任意）
cost-spike-investigation	コスト増加の根本原因分析：対象サービスとリソース、一時的な増加か傾向か、推奨アクション	days（任意）、provider（任意）
executive-summary	経営陣向けの簡潔な非技術的コスト概要：支出、傾向、予算状況、主な要因、予測、重要な推奨事項	provider（任意）
chargeback-report	チャージバック用のタグ／ラベルキー別コスト配分：値ごとの支出、タグ付けされていないリソース、タグ付きとタグなしの内訳、前月比	tag_key（必須）、provider（任意）

ライセンス

MIT