AWS Logo
Menu
DevOps Projects & Architecture Diagrams with Amazon Q CLI & MCP

DevOps Projects & Architecture Diagrams with Amazon Q CLI & MCP

This blog helps you setup Amazon Q CLI with MCP servers, and create cool projects with it.

amazonqcliamazonqtrainwithshubham
Shubham Londhe
Published May 14, 2025
Last Modified May 30, 2025
After Anthropic announced its new Model Context Protocol (MCP) I got a lot of interest in setting it up and running these MCP servers with my go to Coding Assistant Amazon Q CLI.
It is always fun to work with Amazon Q CLI and with MCP Server Support, it can be used to do some amazing DevOps Related tasks like
  • Architectural Diagrams
  • Terraform Code
  • Kubernetes resources
  • I can go on and on but you can check the MCP servers here
So, let's deep dive into it by installing Amazon Q CLI, you can use it for free by creating a BuilderID here (needed for Free Amazon Q CLI usage)

MacOS

On your terminal, run the command
brew install amazon-q
or Download the installer here

WSL (Windows Subsystem For Linux)

Download installation zip file:
curl --proto '=https' --tlsv1.2 -sSf "https://desktop-release.q.us-east-1.amazonaws.com/latest/q-x86_64-linux.zip" -o "q.zip"
  • Unzip the installer:unzip q.zip
  • Run the install program:./q/install.shBy default, the files are installed to ~/.local/bin.

Linux (Ubuntu)

Make sure your machine is updated and has Libfuse2 installed
sudo apt-get update
sudo apt install libfuse2
Install the deb file for Amazon Q
curl --proto '=https' --tlsv1.2 -sSf https://desktop-release.q.us-east-1.amazonaws.com/latest/amazon-q.deb -o amazon-q.deb
Install Amazon Q debian file
sudo apt install -y ./amazon-q.deb
q login
once you have logged in, just write simple command
q
That's it, you're all set to take your DevOps & Cloud skills to the next level with AI.
Write a simple prompt
Create a simple flask application that shares random motivational quotes in Hindi
Or Create a multi-line prompt with /editor That opens a Vim editor
Add your prompt and press esc + :wq to execute the prompt
You have a running project, built within minutes.
Make some cool projects and tag me on LinkedIn, I'll review them :)

MCP Support on Amazon Q CLI

Now let's power up your Amazon Q CLI with MCP Servers.
MCP Servers can be setup locally with npx , uvx, docker
In this blog we have used uvx
If you want to install simply use the commands
MacOS
brew install uv
Linux / WSL
sudo snap install astral-uv --classic
Now create a file called mcp.json in ~/.aws/amazonq
and add this
Now run q again
Amazon Q CLI configured with MCP Server

You are all set now!
If you wish to make Architecture Diagrams like this with Amazon Q CLI and MCP Servers
I have made a detailed Tutorial on YouTube, you can watch it here.
Happy Learning
TrainWithShubham
 

26 Comments