AWS 成本_notifier MCP 服务器

这是一个用于获取 AWS 的月度成本并显示服务详细信息的 MCP 服务器。它每天监控成本变动，并自动将变化报告以 GitHub 问题的形式创建。

功能

• 获取日度 AWS 成本总额
• 服务级别的成本明细
• 按类别汇总的成本（EC2、安全、管理、存储等）
• 前一日比较的变化分析
• 成本信息的 JSON 格式输出
• 自动向 GitHub 问题投稿报告

设置

1. 克隆仓库:

git clone https://github.com/yourusername/aws-cost-notifier-mcp-server.git
cd aws-cost-notifier-mcp-server

2. 安装依赖项包:

npm install

3. 环境变量设置:

   • 将 .env.example 复制为 .env

   cp .env.example .env
   

   • 编辑 .env 文件以配置必要的信息

   # AWS 配置
   AWS_PROFILE=default
   AWS_REGION=ap-northeast-1
   AWS_SDK_LOAD_CONFIG=1
   
   # GitHub 配置
   GITHUB_TOKEN=your_github_token_here
   
   # 目标仓库
   GITHUB_OWNER=your_organization_or_username
   GITHUB_REPO=your_repository_name
   

4. TypeScript 构建:

npm run build

执行方法

直接执行

node build/index.js

作为 Cursor MCP 服务器运行

1. 在 .cursor/mcp.json 中添加以下配置:

{
  "mcpServers": {
    "aws-cost-notifier": {
      "command": "node",
      "args": ["build/index.js"],
      "cwd": "/path/to/aws-cost-notifier-mcp-server",
      "env": {
        "AWS_PROFILE": "default",
        "AWS_REGION": "ap-northeast-1",
        "AWS_SDK_LOAD_CONFIG": "1",
        "GITHUB_TOKEN": "your_github_token",
        "GITHUB_OWNER": "your_organization_or_username",
        "GITHUB_REPO": "your_repository_name"
      }
    }
  }
}

2. 使用 Cursor 执行:

mcp aws-cost-notifier

开发环境

VSCode

此项目包含适用于 VSCode 的推荐设置：

1. 推荐扩展：

• ESLint
• Prettier
• TypeScript 和 JavaScript 语言功能

2. 调试设置:

• 使用 F5 键直接调试 TypeScript 代码
• 环境变量从 .env 文件自动读取

3. 自动格式化:

• 在保存文件时自动格式化
• 启用 ESLint 的自动修复

输出形式

{
  "summary": {
    "period": {
      "start": "2025-04-19",
      "end": "2025-04-20"
    },
    "totalCost": "32.14",
    "previousTotalCost": "31.98",
    "changePercentage": "+0.5",
    "currency": "USD"
  },
  "categories": [
    {
      "name": "ec2",
      "current": "22.97",
      "previous": "22.50",
      "changePercentage": "+2.1",
      "percentage": "71.5"
    }
  ],
  "details": [
    {
      "service": "Amazon Elastic Compute Cloud",
      "current": "21.7158",
      "previous": "21.2345",
      "changePercentage": "+2.3",
      "unit": "USD"
    }
  ]
}

注意事项

• 成本为估算值，确切金额请在月底账单中确认
• 使用 AWS Cost Explorer 可能会产生费用
• 前一日比较显示日度变化，与月度趋势可能不同
• 注意 GitHub 的 API 限制