AWS MCP Server

A Model Context Protocol (MCP) server that provides tools to interact with AWS services through Claude Desktop.

Features

• S3: List buckets, list objects
• EC2: Describe instances, security groups, VPCs
• RDS: Describe database instances
• Cost Explorer: Get cost and usage reports
• CloudWatch: Retrieve metric statistics
• Generic AWS SDK: Access any AWS operation via aws_sdk_wrapper
• Vector Store: Optional document ingestion and search capabilities

Quick Start

Prerequisites

• Python 3.12+
• AWS credentials configured (~/.aws/credentials)
• Claude Desktop installed

Installation

1. Install the package:

   pip install aws-mcp-server
   

2. Configure Claude Desktop: Add to your claude_desktop_config.json:

   {
       "mcpServers": {
           "aws-mcp-server": {
               "command": "aws-mcp-server"
           }
       }
   }
   

3. Configure AWS credentials:

   aws configure
   # OR manually edit ~/.aws/credentials:
   

   [default]
   aws_access_key_id = YOUR_ACCESS_KEY
   aws_secret_access_key = YOUR_SECRET_KEY
   region = us-east-1
   

Development

Local Development Setup

# Clone and install
git clone <repository-url>
cd aws-mcp-server
uv sync

# Run locally
uvx .

Configuration Options

Set environment variables for customization:

export AWS_MCP_PORT=8888
export AWS_MCP_DEBUG=true
export ENABLE_VECTOR_STORE=true

Documentation

• Deployment Guide - Production deployment with AWS App Runner
• Vector Store Guide - Document ingestion and search setup
• Workflow Guide - Development workflows and patterns

License

MIT License - see LICENSE file for details.