aws-billing-mcp

MCPサーバー(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を照会し、月末のコスト予測を1回行います。

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別に分解して、どの部分が最も速く増加していますか?」

環境変数