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 拆开看,哪部分涨得最快?”

环境变量