AWS MCP 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.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
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.
π¬ 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.
Related MCP server: AWS MCP Infrastructure
β¨ 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
pnpminstalled 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 -dOption 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-mcpThe server will be available at:
MCP HTTP Stream:
http://localhost:8080/mcpMCP 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/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
π 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. βοΈ
β‘ Powered by
Available Tools
54 toolsassociate-route-tableBIdempotent
Associate a route table with a subnet or internet gateway or virtual private gateway
Inputs: RouteTableArgs (required), region.
attach-internet-gatewayBIdempotent
Attach an internet gateway to a VPC
Inputs: InternetGatewayArgs (required), region.
authorize-security-group-egressC
Authorize a security group egress in the given region
Inputs: SecurityGroupArgs (required), region.
authorize-security-group-ingressB
Authorize a security group ingress in the given region
Inputs: SecurityGroupArgs (required), region.
create-amiC
Create an AMI
Inputs: AmiArgs (required), region.
create-bucketBIdempotent
Create a new S3 bucket in the given region
Inputs: S3Args (required), region.
create-db-instanceBDestructive
Create a new RDS DB instance in the given region
Inputs: DBInstanceArgs (required), region.
create-instance-tagC
Create instance tag
Inputs: InstanceArgs (required), region.
create-internet-gatewayB
Create a new internet gateway in the given region
Inputs: InternetGatewayArgs (required), region.
create-key-pairC
Create a key pair in the given region
Inputs: KeyPairArgs (required), region.
create-route-tableB
Create a route table in the given region
Inputs: RouteTableArgs (required), region.
create-security-groupB
Create a security group in the given region
Inputs: SecurityGroupArgs (required), region.
create-subnetBIdempotent
Create a subnet in the given region
Inputs: SubnetArgs (required), region.
create-vpcBIdempotent
Create a new VPC in the given region
Inputs: VpcArgs (required), region.
delete-amiCDestructiveIdempotent
Delete an AMI
Inputs: AmiArgs (required), region.
delete-bucketADestructiveIdempotent
Delete an S3 bucket in the given region
Inputs: S3Args (required), region.
delete-db-instanceBDestructive
Delete a given RDS DB instance in the given region
Inputs: DBInstanceArgs (required), region.
delete-instance-tagCDestructiveIdempotent
Delete instance tag
Inputs: InstanceArgs (required), region.
delete-internet-gatewayBDestructiveIdempotent
Delete an internet gateway by ID in the given region
Inputs: InternetGatewayArgs (required), region.
delete-key-pairBDestructiveIdempotent
Delete a key pair in the given region
Inputs: KeyPairArgs (required), region.
delete-route-tableADestructiveIdempotent
Delete a route table in the given region
Inputs: RouteTableArgs (required), region.
delete-security-groupBDestructiveIdempotent
Delete a security group in the given region
Inputs: SecurityGroupArgs (required), region.
delete-subnetBDestructiveIdempotent
Delete a subnet by subnet ID in the given region
Inputs: SubnetArgs (required), region.
delete-vpcBDestructiveIdempotent
Delete a VPC by VPC ID in the given region
Inputs: VpcArgs (required), region.
detach-internet-gatewayBIdempotent
Detach an internet gateway from a VPC
Inputs: InternetGatewayArgs (required), region.
disassociate-route-tableBIdempotent
Disassociate a route table from a subnet or internet gateway or virtual private gateway
Inputs: RouteTableArgs (required), region.
import-key-pairC
Import a key pair in the given region
Inputs: KeyPairArgs (required), region.
launch-ec2-instanceB
Launch an EC2 instance in a given region
Inputs: Ec2Args (required), region.
list-amisCRead-onlyIdempotent
List AMIs
Inputs: AmiArgs (required), region.
list-bucketsBRead-onlyIdempotent
List all the S3 buckets in the given region
Inputs: S3Args (required), region.
list-db-instancesBRead-onlyIdempotent
List all the RDS DB instances in the given region
Inputs: DBInstanceArgs (required), region.
list-ec2-instancesBRead-onlyIdempotent
List EC2 instances in a given region
Inputs: Ec2Args (required), region.
list-instance-tagsCRead-onlyIdempotent
List instance tags
Inputs: InstanceArgs (required), region.
list-internet-gatewaysBRead-onlyIdempotent
List all internet gateways in the given region
Inputs: InternetGatewayArgs (required), region.
list-key-pairsBRead-onlyIdempotent
List key pairs in the given region
Inputs: KeyPairArgs (required), region.
list-route-tablesARead-onlyIdempotent
List route tables in the given region
Inputs: RouteTableArgs (required), region.
list-security-group-rulesBRead-onlyIdempotent
List all security group rules in the given region
Inputs: SecurityGroupRuleArgs (required), region.
list-security-groupsBRead-onlyIdempotent
List all security groups in the given region
Inputs: SecurityGroupArgs (required), region.
list-subnetsBRead-onlyIdempotent
List all the subnets in the given region
Inputs: SubnetArgs (required), region.
list-vpcsBRead-onlyIdempotent
List all the VPCs in the given region
Inputs: VpcArgs (required), region.
modify-security-group-rulesBIdempotent
Modify a security group rule in the given region
Inputs: SecurityGroupArgs (required), region.
reboot-ec2-instanceBIdempotent
Reboot an EC2 instance in a given region
Inputs: Ec2Args (required), region.
replace-route-table-associationAIdempotent
Replace the route table association for a subnet or internet gateway or virtual private gateway
Inputs: RouteTableArgs (required), region.
revoke-security-group-egressBDestructiveIdempotent
Revoke a security group egress in the given region
Inputs: SecurityGroupArgs (required), region.
revoke-security-group-ingressBDestructiveIdempotent
Revoke a security group ingress in the given region
Inputs: SecurityGroupArgs (required), region.
start-ec2-instanceBIdempotent
Start an EC2 instance in a given region
Inputs: Ec2Args (required), region.
stop-ec2-instanceBIdempotent
Stop an EC2 instance in a given region
Inputs: Ec2Args (required), region.
terminate-ec2-instanceBDestructiveIdempotent
Terminate an EC2 instance in a given region
Inputs: Ec2Args (required), region.
update-db-instanceBDestructive
Update a given RDS DB instance in the given region
Inputs: DBInstanceArgs (required), region.
update-security-group-rule-descriptions-egressBIdempotent
Update the description of a security group rule egress in the given region
Inputs: SecurityGroupArgs (required), region.
update-security-group-rule-descriptions-ingressCIdempotent
Update the description of a security group rule ingress in the given region
Inputs: SecurityGroupArgs (required), region.
update-subnet-attributeBIdempotent
Update a subnet attributes by subnet ID in the given region
Inputs: SubnetArgs (required), region.
update-vpc-attributeBIdempotent
Update a VPC attribute(EnableDnsHostnames, EnableDnsSupport, EnableNetworkAddressUsageMetrics) by VPC ID in the given region
Inputs: VpcArgs (required), region.
update-vpc-endpointBIdempotent
Update a VPC endpoint(Gateway endpoint, Interface endpoint) by VPC endpoint ID in the given region
Inputs: VpcArgs (required), region.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 54 tools
Most tools have distinct purposes targeting specific AWS resources and actions, with clear boundaries (e.g., create-vpc vs. update-vpc-attribute). However, some overlap exists in security group operations (authorize/revoke egress/ingress vs. modify-security-group-rules), which could cause minor confusion for agents.
Tool names follow a highly consistent verb-noun pattern with hyphens throughout (e.g., create-vpc, list-subnets, delete-ami). All 54 tools adhere to this convention, making them predictable and easy to parse.
With 54 tools, the count is excessive for a single server, likely overwhelming for agents. While AWS is a broad domain, this feels heavy and could be better scoped into multiple servers (e.g., separate EC2, VPC, S3 servers) for improved usability.
The tool set provides comprehensive CRUD and lifecycle coverage across AWS services like EC2, VPC, S3, and RDS. It includes creation, listing, updating, and deletion for most resources, with no obvious gaps for core operations, ensuring agents can handle full workflows.
Related MCP Connectors
Designs, prices, and deploys AWS/GCP cloud infrastructure from plain-English requirements.
Provides capabilities that let LLM agents perform a range of infrastructure management tasks.
Build, deploy, and run apps on AWS, GCP, Azure, Oracle Cloud, and your own hardware from chat.
Your AI Agent's Infrastructure Layer. Connect Claude, Copilot, Codex, or ChatGPT to 200+ managed open source services. Start databases, pipelines, and applications through natural language.
Related MCP Servers
- AlicenseCqualityDmaintenanceA Model Context Protocol server allowing Claude AI to interact with AWS resources through natural language, enabling users to query and manage AWS services without using the traditional AWS Console or CLI.36ISC
- AlicenseNot gradedqualityNot gradedmaintenanceProvides a chat interface with natural language processing to deploy and manage AWS resources through an integrated Model Context Protocol (MCP) server.2-
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to execute AWS CLI commands and retrieve service documentation through the Model Context Protocol. It supports Unix pipes for output filtering and provides pre-defined prompt templates for common cloud management tasks.MIT
- AlicenseNot gradedqualityCmaintenanceProvides a comprehensive suite of tools for interacting with AWS services like S3, EC2, and Lambda using natural language commands. It enables AI assistants to inspect, manage, and operate AWS resources directly through the Model Context Protocol using your local credentials.1Apache 2.0