AWS MCP
About
A natural language interface to manage AWS services like RDS, S3, EC2, and VPC.
Details
- Author
- lokeswaran-aj
- Categories
- Cloud Service, Other, Infrastructure, Database
Jump to
Setup
Install AWS MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/lokeswaran-aj/aws-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
See it in action! Here's how easy it is to spin up a full-blown EC2 setup — VPC, subnets, security groups, this works — all through natural language prompts to an AI Model Context Protocol (MCP) server.
- RDS
- S3
- EC2
- VPC
- Subnet
- Internet Gateway
- Route Table
- Security Group
- Key Pair
- Instance Tag
- AMI
More AWS services (like Lambda, API Gateway, etc.) coming soon! Contributions welcome 🚀
- AWS Accountwith AWS credentials (Access Key ID and Secret Access Key)
git clone https://github.com/lokeswaran-aj/aws-mcp.git cd aws-mcp
❗️Currently, the server reads credentials from MCP configuration headers. In future versions, we'll support AWS Role ARN.
💡 Make sure you havepnpminstalled globally. If not:
Option 1: Using Docker Compose (Recommended)
# Build the image docker build -t aws-mcp . # Run with port mapping docker run -d --name aws-mcp-server -p 8080:8080 aws-mcp
- MCP HTTP Stream:http://localhost:8080/mcp
- MCP SSE:http://localhost:8080/sse
# View logs docker-compose logs -f # Stop container docker-compose down # Rebuild and restart docker-compose build --no-cache && docker-compose up -d # Stop aws-mcp-server and remove container docker stop aws-mcp-server && docker rm aws-mcp-server
💡 AWS credentials are still passed via HTTP headers (same as development setup). No container configuration needed.
To use this server withCursor, add the following to your~/.cursor/mcp.json:
{ "mcpServers": { "aws": { "serverUrl": "http://localhost:8080/mcp", "headers": { "AWS_ACCESS_KEY_ID": "YOUR_AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY": "YOUR_AWS_SECRET_ACCESS_KEY", "AWS_SESSION_TOKEN": "YOUR_AWS_SESSION_TOKEN" } } } }
❗️ Usehttp://localhost:8080/mcpif your client supports HTTP streamable(For eg: Cursor). Usehttp://localhost:8080/sseif your client supports only SSE(For eg: Windsurf).
MCP HTTP streamable endpoint:http://localhost:8080/mcp
MCP SSE endpoint:http://localhost:8080/sse
. ├── src/ │ ├── server.ts # AWS MCP server setup - Entry point │ ├── aws-clients.ts # AWS SDK client setup │ ├── config/ # App configuration │ ├── tools/ # Tools definitions │ │ ├── rds/ # RDS operations │ │ ├── s3/ # S3 operations │ │ ├── ec2/ # EC2 operations │ │ ├── vpc/ # VPC operations │ │ ├── subnet/ # Subnet operations │ │ ├── internet-gateway/ # Internet Gateway operations │ │ ├── route-table/ # Route Table operations │ │ ├── security-group/ # Security Group operations │ │ ├── key-pair/ # Key Pair operations │ │ ├── instance-tag/ # Instance Tag operations │ │ ├── ami/ # AMI operations │ ├── schema/ # Tool input schemas │ ├── types/ # TypeScript definitions │ └── utils/ # Helper functions ├── package.json # Dependencies and scripts └── README.md # This file
- Support RDS (Create, List, Update, Delete)
- Add S3 tools
- Add Network tools
- Add EC2 tools
- Add Lambda tools
- Add API Gateway tools
- Add IAM tools
- Add ECS tools
Want to help make AWS infra chat-native? Pull requests, feedback, and feature suggestions are welcome!
- Clone and fork the repo
- Create your feature branch (git checkout -b feat/add-ec2)
- Commit and push
- Open a PR 🙌
MIT — do what you want, just give credit where it's due. ✌️
- Model Context Protocol
- FastMCP
- AWS SDK for JS (v3)
Generate and execute AWS CLI commands using natural language.
Core AWS MCP server providing prompt understanding and server management capabilities.
Interact with your AWS environment using natural language to query and manage resources. Requires local AWS credentials.
Interact with your AWS environment using natural language. Requires local AWS credentials.
Execute AWS CLI commands through the Model Context Protocol (MCP). Requires AWS credentials configured on the host.
A daemon to orchestrate MCP servers as Docker containers and configure AWS ALB path-based routing.
Manage cloud infrastructure using Pulumi's Infrastructure as Code (IaC) platform. Requires the Pulumi CLI to be installed.
Manage your Bedrock server with natural language commands using the Bedrock Server Manager API.
Get prescriptive CDK advice, explain CDK Nag rules, check suppressions, generate Bedrock Agent schemas, and discover AWS Solutions Constructs patterns.
Manage and interact with Microsoft Azure services.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
