🎬 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

1. RDS
2. S3
3. EC2
4. VPC
5. Subnet
6. Internet Gateway
7. Route Table
8. Security Group
9. Key Pair
10. Instance Tag
11. AMI

More AWS services (like EC2, Lambda, etc.) coming soon! Contributions welcome 🚀

---

📋 Prerequisites

• Node.js >= 18.0.0
• pnpm >= 10.0.0
• 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

2. Set up environment variables

cp .env.example .env

Then update your AWS credentials inside .env. Make sure you've created an IAM user with appropriate permissions.

❗️Currently, the server reads credentials from environment variables. In future versions, we'll support secure credential injection or AWS SSO.

3. Install dependencies

pnpm install

💡 Make sure you have pnpm installed globally. If not:

npm install -g pnpm

4. Run the dev server

pnpm dev

The server will start on the port specified in your .env file (default is 8080).

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

---

🧪 Example: Windsurf Configuration

To use this server with Windsurf IDE, add the following to your ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "aws": {
      "serverUrl": "http://localhost:8080/sse"
    }
  }
}

---

📁 Project Structure

.
├── src/
│   ├── index.ts              # Entry point
│   ├── server.ts             # AWS MCP server setup
│   ├── aws-clients.ts        # AWS SDK client setup
│   ├── config/               # App configuration
│   ├── controllers/          # MCP request handlers
│   ├── routes/               # API endpoints
│   ├── tools/                # Tools definitions
│   │   └── rds/              # RDS operations (create, list, delete, update)
│   ├── schema/               # Tool input schemas
│   ├── services/             # Transport handler
│   ├── 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 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

• Model Context Protocol
• AWS SDK for JS (v3)