Aws Cost Notifier MCP Server

🚀 AWS 成本_notifier MCP 服務器

這是一個用於獲取 AWS 月度成本並顯示服務詳細信息的 MCP 服務器。它會每天監控成本變動，並自動以 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 限制