aws-cost-notifier-mcp-server

AWS Cost Notifier MCP Server

AWSの月間コストを取得し、サービス別の内訳を表示するMCPサーバーです。 日次でコストの変動を監視し、前日比較のレポートをGitHub Issueとして自動作成します。

機能

• 日次のAWSコスト総額の取得
• サービス別のコスト内訳
• カテゴリー別のコスト集計（EC2、セキュリティ、管理、ストレージなど）
• 前日比較による変動の分析
• コスト情報のJSON形式での出力
• GitHub Issueへの自動レポート投稿

セットアップ

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 Configuration
   AWS_PROFILE=default
   AWS_REGION=ap-northeast-1
   AWS_SDK_LOAD_CONFIG=1
   
   # GitHub Configuration
   GITHUB_TOKEN=your_github_token_here
   
   # Target Repository
   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 and JavaScript Language Features

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