Aws Cost Notifier MCP Server

🚀 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

出力形式

{
  "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制限に注意してください。