aws-billing-mcp

MCP server(stdio)——로컬 AWS CLI를 통해 <대상 AWS 계정>의 Billing and Cost Management 데이터에 접근하여 Quick Desktop 등 MCP 클라이언트에서 소비/사용량 분석을 할 수 있게 합니다.

사전 요구 사항

• Node.js ≥ 18(로컬에 v24 설치됨)

• AWS CLI v2, default profile(또는 AWS_PROFILE로 지정된 profile)의 자격 증명이 <대상 AWS 계정>에 속해야 합니다

• IAM 권한: ce:Get*, budgets:ViewBudget, sts:GetCallerIdentity

서버는 도구를 처음 호출할 때 sts get-caller-identity로 현재 자격 증명이 실제로 <대상 AWS 계정>에 속하는지 검증하며, 일치하지 않으면 바로 오류를 반환하여 다른 계정을 잘못 조회하는 것을 방지합니다.

Related MCP server: aws-cost-mcp

설치

cd ~/aws-billing-mcp
npm install

스모크 테스트

node test-client.mjs

전체 도구를 나열하고, 이번 달 서비스별 비용 Top5를 조회하며, 월말 비용 예측을 한 번 수행합니다.

Quick Desktop 연동

Quick Desktop의 MCP 서버 구성(Settings → 통합/MCP servers 또는 해당 JSON 구성 파일)에 다음을 추가합니다:

{
  "mcpServers": {
    "aws-billing": {
      "command": "node",
      "args": ["~/aws-billing-mcp/index.mjs"],
      "env": {
        "AWS_PROFILE": "default"
      }
    }
  }
}

참고: node는 nvm으로 설치되었습니다(~/.nvm/versions/node/v24.8.0/bin/node). Quick Desktop 시작 시 node나 aws를 찾지 못하면 command를 node의 절대 경로로 바꾸고, env에 "PATH": "/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin"(aws가 있는 디렉터리 포함)을 추가하세요.

도구 목록

일반적인 분석 질문(Quick Desktop에서)

• “이 계정 이번 달에 얼마나 썼나요? 서비스별로 Top 10을 정렬해 주세요.”

• “최근 30일간 일별 Bedrock 소비 추세에 이상 스파이크가 있나요?”

• “8월 말 총 청구 금액을 예측해 주세요.”

• “EC2 비용을 usage type별로 나눠 보면 어느 부분이 가장 빠르게 증가하나요?”

환경 변수