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`	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