aws-cost-notifier-mcp-server

🚀 AWS 成本_notifier MCP 服务器

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

✨ 主要特性

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

📦 安装指南

克隆仓库

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

安装依赖项包

npm install

环境变量设置

• 将 .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

TypeScript 构建

npm run build

💻 使用示例

直接执行

node build/index.js

作为 Cursor MCP 服务器运行

配置 .cursor/mcp.json

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

使用 Cursor 执行

mcp aws-cost-notifier

📚 详细文档

开发环境 - VSCode

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

推荐扩展

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

调试设置

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

自动格式化

• 在保存文件时自动格式化。
• 启用 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 限制。