================== /// MCP /// /// AWS /// ================== [server:online] [protocol:ready]
aws-mcp-server
by alexei-led
Light-weight Model Context Protocol (MCP) server that lets AI assistants safely request AWS-CLI documentation and execute AWS commands (with Unix-pipe support) inside an isolated Docker container.
143
21
Open Source01
aws_cli_help
Retrieve detailed AWS CLI documentation for AWS services and commands.
02
aws_cli_pipeline
Execute AWS CLI commands (with optional Unix pipes) and return formatted results optimized for AI consumption.
Installation
1. Prerequisites:
• Docker installed and running
• An AWS IAM user or role with the minimal permissions you want the server to have
• Environment variables AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and (optionally) AWS_SESSION_TOKEN, AWS_REGION set
2. Clone the repository
git clone https://github.com/alexei-led/aws-mcp-server.git
cd aws-mcp-server
3. Build the container image (replace tag as desired)
docker build -t aws-mcp-server:latest .
4. Launch the server (exposes MCP on port 3333 by default)
docker run -d --name aws-mcp-server \
-e AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID \
-e AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY \
-e AWS_SESSION_TOKEN=$AWS_SESSION_TOKEN \
-e AWS_REGION=${AWS_REGION:-us-east-1} \
-p 3333:3333 \
aws-mcp-server:latest
# OR with an AWS credentials file mounted
# docker run -d -p 3333:3333 -v $HOME/.aws:/root/.aws aws-mcp-server:latest
5. Verify it is reachable
curl http://localhost:3333/healthz
6. Point your MCP-aware client (Claude, Cursor, etc.) at http://<host>:3333 to start issuing AWS CLI commands.
Documentation
# Transform Augment Code into Your Complete AWS Infrastructure Assistant The **AWS MCP Server** supercharges Augment Code by bridging the gap between code generation and cloud infrastructure management. Instead of switching between your IDE and AWS console, you can now manage your entire AWS environment directly through Augment—all within your coding workflow. ## Seamless AWS Integration in Your Coding Environment This MCP server transforms Augment Code from a pure coding assistant into a comprehensive AWS infrastructure partner. When you're developing cloud applications, Augment can now: - **Provision AWS resources** while you're writing the code that uses them - **Debug deployment issues** by querying AWS services directly from your editor - **Optimize costs** by analyzing your current AWS usage patterns - **Audit security settings** across your entire AWS infrastructure - **Generate infrastructure-as-code** based on your existing AWS resources The server runs all AWS CLI commands in isolated Docker containers, ensuring your host system stays secure while giving Augment full access to AWS operations with Unix pipe support for complex data processing. ## Real-World Developer Workflows **Scenario 1: Building a Serverless API** ``` You: "I need to create a Lambda function that processes S3 events" Augment: *creates the Lambda code AND provisions the S3 bucket, sets up event triggers, configures IAM roles, and deploys the function—all in one conversation* ``` **Scenario 2: Debugging Production Issues** ``` You: "My app is throwing 500 errors in production" Augment: *checks CloudWatch logs, analyzes error patterns, examines related AWS resources, and suggests fixes—without leaving your IDE* ``` **Scenario 3: Security Audit During Development** ``` You: "Make sure this new service follows security best practices" Augment: *audits S3 bucket policies, reviews IAM permissions, checks security groups, validates encryption settings, and provides compliance recommendations* ``` The server includes 15+ pre-built prompt templates for common AWS tasks like `security_audit`, `cost_optimization`, `infrastructure_automation`, and `disaster_recovery`—turning complex AWS operations into simple conversations with Augment. ## Setup with Augment Code Add this server to your Augment Code configuration to unlock comprehensive AWS capabilities: ```json { "mcpServers": { "aws-mcp-server": { "command": "docker", "args": [ "run", "-i", "--rm", "-v", "/Users/YOUR_USERNAME/.aws:/home/appuser/.aws:ro", "ghcr.io/alexei-led/aws-mcp-server:latest" ] } } } ``` With this setup, Augment Code becomes your complete AWS development environment—combining intelligent code generation with secure, real-time cloud infrastructure management. Every AWS operation runs in an isolated container with comprehensive security controls, so you can confidently let Augment manage your cloud resources while you focus on building great applications.
License: MIT License
Updated 7/15/2025