MCP

AWS MCP Servers are specialized components that seamlessly integrate AWS best practices into your development workflow, enabling intelligent infrastructure automation and design guidance at every step.

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

Installing Amazon Q CLI, you can use it for free by creating a BuilderID here (needed for Free Amazon Q CLI usage)

Steps to install on Linux (Ubuntu)

1. Update Your machine First

  $ sudo apt-get update

2. Install Libfuse2

sudo apt install libfuse2

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

4. Install Amazon Q debian file

sudo apt install -y ./amazon-q.deb

5. AND final Login to q

q login

6. Authenticate You have 2 options to sign-in and this blog explores both the authentication methods :
7. with Builder ID for Individual users with Free Tier
8. with AWS IAM Identity Center for Professional users with Pro Tier

But We are using free tier for this blog

8. Press ENTER and You will get one url for authentication
9. once you will get the url copy that url paste in google search bar and you will get AWS Builder authentication page once click Confirm and continue

9.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 Web application using html, css, javascript Or Create a multi-line prompt with /editor That opens a Vim editor Add your prompt and press esc + :wq to execute the prompt

Let’s Do cool project using Amazon Q + MCP servers

MCP Servers can be setup locally with npx , uvx, docker But In this blog i used uvx

What is uvx

The uvx command is used with Amazon Q CLI to interact with Universal Virtual eXecutor (UVX) — a feature that allows Amazon Q to execute tasks, run tools, and interact with your local dev environment based on AI-generated suggestions.

uvx stands for Universal Virtual eXecutor, and it’s a command-line interface used to:

• Run AI-generated commands
• Launch development tools
• Execute infrastructure tasks
• Integrate with MCP servers for intelligent DevOps workflows

Install uvx Linux / WSL

sudo snap install astral-uv --classic

Now create a file called mcp.json in cd ./aws/amazonq/ Add below MCP Server code into mcp.json file

{

        "mcpServers" : {

                "awslabs.cdk-mcp-server": {
                        "command": "uvx",
                        "args": ["awslabs.cdk-mcp-server@latest"], # this Amazon Q CLI can launch using uvx, with specific arguments and environment variables for runtime behavior
                        "env": {
                        "FASTMCP_LOG_LEVEL": "ERROR"
                        }
                },
                "awslabs.aws-diagram-mcp-server": {
                        "command": "uvx",
                        "args": ["awslabs.aws-diagram-mcp-server"], #Launches an MCP server that enables Amazon Q CLI to generate AWS architecture diagrams from natural language prompts.
                        "env": {
                                "FASTMCP_LOG_LEVEL": "ERROR"
                        },
                        "autoApprove": [],
                        "disabled": false
                },
                "kubernetes-mcp-server": {
                        "command": "uvx",
                        "args":["kubernetes-mcp-server@latest"], # Starts an MCP server that helps Amazon Q CLI generate Kubernetes manifests (like deployments, services, HPAs) using AI-driven prompts.
                        "env": {
                                "FASTMCP_LOG_LEVEL": "ERROR"
                        }
                }

        }
}

Now Run q again

Amazon Q CLI configured with MCP Server

Write prompt for whatever architecture diagram and you will get output like this

Basic Commands for amazon q

1. Login In q

q login

2. Enter into q

q

3. Exit from q

/quit

4. MCP server are loaded or not check

/tools

5. Clear History

!clear

6. If you want to run any command in q

!uvx kubernetes-mcp-server@latest

---

Happy Learning ❤️ Feel free to Contact me if you have any query or issue related Amazon Q or MCP Servers Setup Vinayak Z. Mobile Number :- 7848849869 Email Id :- [email protected] DevOps Engineer