Aws Cost Notifier MCP Server

🚀 AWS Cost Notifier MCP Server

This is an MCP server designed to retrieve AWS monthly costs and display detailed service information. It monitors cost changes daily and automatically creates reports of these changes as GitHub issues.

✨ Features

• Retrieve the total daily AWS costs.
• Get cost details at the service level.
• Aggregate costs by category (EC2, security, management, storage, etc.).
• Conduct a change analysis compared to the previous day.
• Output cost information in JSON format.
• Automatically submit reports to GitHub issues.

📦 Installation

1. Clone the repository:

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

2. Install the dependency packages:

npm install

3. Set up environment variables:

   • Copy .env.example to .env

   cp .env.example .env
   

   • Edit the .env file to configure the necessary information

   # 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. Build TypeScript:

npm run build

💻 Usage Examples

Basic Usage

node build/index.js

Advanced Usage

1. Add the following configuration to .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. Execute using Cursor:

mcp aws-cost-notifier

📚 Documentation

Development Environment - VSCode

This project includes recommended settings for VSCode:

1. Recommended extensions:

• ESLint
• Prettier
• TypeScript and JavaScript Language Features

2. Debugging settings:

• Debug TypeScript code directly using the F5 key.
• Environment variables are automatically read from the .env file.

3. Automatic formatting:

• Automatically format files when saving.
• Enable ESLint's automatic fix.

Output Format

{
  "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"
    }
  ]
}

⚠️ Important Note

• The costs are estimated values. Please confirm the exact amount in the end - of - month bill.
• Using AWS Cost Explorer may incur fees.
• The comparison with the previous day shows daily changes, which may differ from the monthly trend.
• Be aware of GitHub's API limits.