MCP 服务器

AWS Cost Explorer MCP Server

Enables querying AWS costs and usage data from Claude Desktop through the Cost Explorer API.

README

AWS Cost Explorer MCP Server

A Model Context Protocol (MCP) server that provides AWS Cost Explorer API access to Claude Desktop. Query your AWS costs and usage data directly from Claude conversations.

Architecture

Local MCP Server (Current Implementation)

graph TB
    subgraph "Your Machine"
        CD[Claude Desktop]
        MCP[MCP Server<br/>Node.js Process]
        ENV[.env file<br/>AWS Credentials]

        CD -->|stdio| MCP
        MCP -->|reads| ENV
    end

    subgraph "AWS Cloud"
        CE[Cost Explorer API]
    end

    MCP -->|HTTPS| CE

    style CD fill:#4A90E2
    style MCP fill:#50C878
    style CE fill:#FF9900

Component Flow

sequenceDiagram
    participant Claude Desktop
    participant MCP Server
    participant AWS Cost Explorer

    Claude Desktop->>MCP Server: Request cost data (stdio)
    MCP Server->>MCP Server: Load AWS credentials from env
    MCP Server->>AWS Cost Explorer: GetCostAndUsage API call

    alt API Success
        AWS Cost Explorer-->>MCP Server: Cost data response
        MCP Server-->>Claude Desktop: Formatted cost data
    else Rate Limited
        AWS Cost Explorer-->>MCP Server: ThrottlingException
        MCP Server-->>Claude Desktop: Error: Rate limit exceeded
    else Other Error
        AWS Cost Explorer-->>MCP Server: Error response
        MCP Server-->>Claude Desktop: Error message
    end

System Architecture

graph LR
    subgraph "MCP Server Components"
        A[index.ts<br/>MCP Protocol Handler]
        B[cost-explorer.ts<br/>AWS Client Wrapper]
    end

    A -->|uses| B
    B -->|AWS SDK| C[Cost Explorer API]

    style A fill:#E8F4F8
    style B fill:#FFF4E6
    style C fill:#FF9900

Features

Simple Cost Queries: Get cost and usage data for any time period
Flexible Grouping: Group costs by Service, Usage Type, Region, Account, etc.
Multiple Metrics: BlendedCost, UnblendedCost, AmortizedCost, and more
Rate Limit Handling: Respects AWS API constraints with proper error handling
Secure: Credentials stay local, no hardcoded secrets

Prerequisites

Node.js 18+
AWS Account with Cost Explorer enabled
AWS IAM credentials with ce:GetCostAndUsage permission
Claude Desktop application

Installation

Clone the repository

git clone <repository-url>
cd aws-mcp-cost-explorer

Install dependencies
```
npm install
```

Configure environment variables

cp .env.example .env

Edit .env and configure for your authentication method:

Option A: AWS SSO (Recommended)

AWS_REGION=us-west-2
AWS_PROFILE=your-sso-profile-name

Then login via SSO:

aws sso login --profile your-sso-profile-name

Option B: IAM Credentials

AWS_ACCESS_KEY_ID=your_access_key_here
AWS_SECRET_ACCESS_KEY=your_secret_key_here
AWS_REGION=us-east-1

Build the project
```
npm run build
```

Configuration

Claude Desktop Setup

Add this configuration to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Option A: AWS SSO (Recommended)

{
  "mcpServers": {
    "aws-cost-explorer": {
      "command": "node",
      "args": ["/absolute/path/to/aws-mcp-cost-explorer/build/index.js"],
      "env": {
        "AWS_REGION": "us-west-2",
        "AWS_PROFILE": "your-sso-profile-name"
      }
    }
  }
}

Option B: IAM Credentials

{
  "mcpServers": {
    "aws-cost-explorer": {
      "command": "node",
      "args": ["/absolute/path/to/aws-mcp-cost-explorer/build/index.js"],
      "env": {
        "AWS_ACCESS_KEY_ID": "your_access_key",
        "AWS_SECRET_ACCESS_KEY": "your_secret_key",
        "AWS_REGION": "us-east-1"
      }
    }
  }
}

Option C: Use default AWS credentials

{
  "mcpServers": {
    "aws-cost-explorer": {
      "command": "node",
      "args": ["/absolute/path/to/aws-mcp-cost-explorer/build/index.js"]
    }
  }
}

This uses credentials from ~/.aws/credentials or environment variables automatically.

Required IAM Permissions

Your AWS IAM user/role needs these permissions:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ce:GetCostAndUsage"
      ],
      "Resource": "*"
    }
  ]
}

Available Tools

`get_cost_and_usage`

Query AWS Cost Explorer for cost and usage data.

Parameters:

startDate (required): Start date in YYYY-MM-DD format
endDate (required): End date in YYYY-MM-DD format
granularity (optional): DAILY, MONTHLY, or HOURLY (default: DAILY)
metrics (optional): Array of metrics to retrieve (default: BlendedCost, UnblendedCost)
- Available: BlendedCost, UnblendedCost, AmortizedCost, NetAmortizedCost, UsageQuantity, NormalizedUsageAmount
groupBy (optional): Array of dimensions to group by
- Example: [{"type": "DIMENSION", "key": "SERVICE"}]
- Common dimensions: SERVICE, USAGE_TYPE, REGION, LINKED_ACCOUNT, INSTANCE_TYPE

Example Queries in Claude:

"What were my AWS costs last month?"

"Show me daily costs for the last 7 days grouped by service"

"Get my AWS costs from 2024-01-01 to 2024-01-31 by service"