Which integrations are available for this server?

Provides comprehensive management of AWS infrastructure, allowing users to create, list, update, and delete resources across services such as EC2, S3, RDS, VPC, and associated networking components through natural language prompts.

How do I use AWS MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@AWS MCP Server Create a t2.micro EC2 instance with a public security group" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

AWS MCP Server by lokeswaran-aj

🎬 Demo

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.

✨ Features

Currently supports

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 🚀

📋 Prerequisites

For Development:

Node.js >= 18.0.0
pnpm >= 10.0.0

For Docker Deployment:

Docker and Docker Compose

For Both:

AWS Account with AWS credentials (Access Key ID and Secret Access Key)

⚙️ Developer Setup

1. Clone the repo

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.

2. Install dependencies

pnpm install

💡 Make sure you have pnpm installed globally. If not:
npm install -g pnpm

3. Run the dev server

pnpm dev

🐳 Docker Deployment

Quick Start with Docker

Option 1: Using Docker Compose (Recommended)

docker-compose up -d

Option 2: Using Docker directly

# Build the image docker build -t aws-mcp . # Run with port mapping docker run -d --name aws-mcp-server -p 8080:8080 aws-mcp

The server will be available at:

MCP HTTP Stream: http://localhost:8080/mcp
MCP SSE: http://localhost:8080/sse

Managing Docker Containers

# 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.

🧪 Example: Cursor Configuration

To use this server with Cursor, 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" } } } }

❗️ Use http://localhost:8080/mcp if your client supports HTTP streamable(For eg: Cursor). Use http://localhost:8080/sse if your client supports only SSE(For eg: Windsurf).

MCP HTTP streamable endpoint: http://localhost:8080/mcp

MCP SSE endpoint: http://localhost:8080/sse

📁 Project Structure

. ├── 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

📌 Roadmap

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

🤝 Contributing

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 🙌

📄 License

MIT — do what you want, just give credit where it's due. ✌️

AWS MCP Server