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

로컬 개발 시 서비스 주체(Service Principal)는 필요하지 않습니다. 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 호출은 쓰기 권한이 없는 비용 관리 읽기 권한자(Cost Management Reader) 권한을 사용합니다.

FAQ

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