{"id":76803,"date":"2025-11-19T13:24:40","date_gmt":"2025-11-19T07:54:40","guid":{"rendered":"https:\/\/www.tothenew.com\/blog\/?p=76803"},"modified":"2025-11-21T13:52:42","modified_gmt":"2025-11-21T08:22:42","slug":"enhancing-the-power-of-amazon-q-integrating-open-source-mcp-servers-and-creating-seamless-aws-architectural-diagrams","status":"publish","type":"post","link":"https:\/\/www.tothenew.com\/blog\/enhancing-the-power-of-amazon-q-integrating-open-source-mcp-servers-and-creating-seamless-aws-architectural-diagrams\/","title":{"rendered":"Enhancing the Power of Amazon Q: Integrating Open-Source MCP Servers and Creating Seamless AWS Architectural Diagrams"},"content":{"rendered":"

Introduction<\/h2>\n

In this blog, we will explore how to integrate an open-source MCP server with Amazon Q and unlock its enhanced capabilities, creating seamless architecture diagrams generation.<\/p>\n

Take a look at this architectural diagram below –<\/p>\n

\"Diagram

Diagram generated by Amazon Q + MCP<\/p><\/div>\n

Isn’t it amazing?<\/p>\n

You will be surprised to know it was not created manually by draw.io or any other diagramming websites rather it was generated in just minutes just by giving simple prompts, using the power of AI (Amazon Q + MCP).<\/p>\n

By the end of this BLOG you will be able to create such magical diagrams by writing prompts
\nBut before that, let\u2019s quickly understand the basics of LLM\u2019s and MCP<\/p>\n

LLM (Large Language Model) \u2013<\/strong> Examples include GPT and Amazon Q. These models are trained on massive datasets and can understand, reason, and generate human-like text. They act as the “brain” that processes your queries and provides intelligent responses.<\/p>\n

MCP (Model Context Protocol) \u2013<\/strong> MCP is an open protocol that allows LLMs to connect with external tools, data sources, and services. Think of it as a bridge. that lets your AI go beyond just text generation and actually interact with APIs, databases, and other systems.<\/p>\n

\"mcp-architecture-diagram-aws\"

mcp-architecture-diagram-aws<\/p><\/div>\n

When combined, Amazon Q (LLM) + MCP give you a powerful setup \u2014where Amazon Q acts as the intelligent LLM, and MCP extends its capabilities by connecting it with the tools and data you need. Together, they enable faster automation, smarter workflows, and richer integrations.<\/p>\n

Read More from AWS Official Documentation<\/em><\/a><\/p>\n

Let\u2019s get started!<\/p>\n

We\u2019ll set up MCP server with Amazon Q and tap into the power of open-source MCP servers\u00a0 to generate stunning architecture diagrams\u00a0 of our AWS infrastructure.<\/p>\n

For this setup, we\u2019ll be using an Ubuntu EC2 instance on AWS !<\/p>\n

Update the system<\/strong>
\nsudo apt-get update<\/em><\/p>\n

\"Update

Update system<\/p><\/div>\n

Install libfuse<\/strong>
\nsudo apt install libfuse2<\/em><\/p>\n

\"Install

Install libfuse2<\/p><\/div>\n

Download the Amazon Q Debian package<\/strong>
\ncurl –proto ‘=https’ –tlsv1.2 -sSf https:\/\/desktop-release.q.us-east-1.amazonaws.com\/latest\/amazon-q.deb -o amazon-q.deb<\/em><\/p>\n

\"Install

Install AmazonQ<\/p><\/div>\n

Install Amazon Q
\n<\/strong>sudo apt install -y .\/amazon-q.deb<\/em><\/p>\n

\"AmazonQ

AmazonQ Installation<\/p><\/div>\n

Login!<\/strong>
\nNext, let\u2019s log in to Amazon Q
\nRun the following command:
\nq login<\/em><\/p>\n

Now we will be prompted with few login methods, for simplicity we will just proceed with “Use Free with Builder ID” and we will be given a Code to confirm on our browser.<\/p>\n

\"q

q login<\/p><\/div>\n

\"Login

Login Confirmation<\/p><\/div>\n

After confirming the code and allowing the access on our browser, our terminal will show login successful message.<\/p>\n

\"Login

Login succeeded<\/p><\/div>\n

Using AmazonQ<\/strong><\/p>\n

Now that we have logged with our BuilderID, we can start using AmazonQ
\nPress q to login into AmazonQ<\/p>\n

\"AmazonQ

AmazonQ Logged In<\/p><\/div>\n

We can start asking questions directly to Amazon Q, and it will respond intelligently with context-aware answers.<\/strong><\/p>\n

\"Question

Question asked to AmazonQ on EIP charges<\/p><\/div>\n

Now lets get started
\nWe\u2019ll ask it to generate an architecture diagram for S3 Static website Hosting.<\/em><\/strong>
\nJust a reminder!<\/strong>\u2014we haven\u2019t yet integrated the open-source MCP server. So let\u2019s first see what the output looks like without MCP<\/strong><\/p>\n

\"Asking

Asking AmazonQ to generate Architectural Diagrams<\/p><\/div>\n

As we can see, Amazon Q is currently relying on Python libraries<\/strong> to generate diagrams.<\/p>\n

\"AmazonQ

AmazonQ is Using Pyhton Libraries to build the diagrams<\/p><\/div>\n

And below is the diagram that AmazonQ generates.<\/p>\n

\"Architectural

Architectural Diagram created by AmazonQ<\/p><\/div>\n

They\u2019re decent\u2026 but nothing close to the magic we\u2019ll unlock once MCP servers come into play.<\/p>\n

Integrating Amazon Q with MCP Servers
\n<\/strong>Now, let\u2019s integrate Amazon Q with MCP servers and compare the outputs. Open this<\/a> link to explore AWS MCP servers. When you will open the website you will be able to see and explore a bunch of AWS MCP servers in the left pane. We will use the AWS Diagram MCP Server<\/strong><\/p>\n

\"AWS

AWS MCP servers<\/p><\/div>\n

After installing the prerequisites (sudo snap install astral-uv –classic)<\/em> we will configure the MCP server in our AmazonQ by placing the mentioned JSON file in the path \/.aws\/amazonq\/mcp.json<\/em><\/p>\n

\"aws

aws mcp servers<\/p><\/div>\n

 <\/p>\n

Create mcp.json file in the directory \/.aws\/amazonq<\/em><\/p>\n

\"create

create mcp.json file<\/p><\/div>\n

Paste the MCP JSON for AWS Architectural diagrams in the mcp.json file<\/p>\n

\"Pasting

Pasting the mcp server JSON<\/p><\/div>\n

 <\/p>\n

After configuring the mcp server when we will login again into AmazonQ we will now see that AmazonQ has Loaded our MCP server for AWS Diagrams.<\/p>\n

\"Loaded

Loaded MCP<\/p><\/div>\n

Now when we will Give the same prompt to create Architecture diagram of S3 Website Hosting <\/em>AmazonQ will use the digrams MCP server package<\/strong> to create stunning Architectural diagrams.<\/p>\n

\"Using

Using Diagrams<\/p><\/div>\n

 <\/p>\n

Below are some Archictectural diagrams created using AmazonQ + MCP integration<\/p>\n

\"Web

Web App with ALB<\/p><\/div>\n

 <\/p>\n

\"SNS-Multi-Topic\"

SNS-Multi-Topic<\/p><\/div>\n

 <\/p>\n

This is not limited to generating diagrams\u2014there are numerous other MCP servers available online for a variety of use cases. Below are some useful references:
\nhttps:\/\/awslabs.github.io\/mcp\/
\nhttps:\/\/github.com\/awslabs\/mcp<\/p>\n

 <\/p>\n

 <\/p>\n","protected":false},"excerpt":{"rendered":"

Introduction In this blog, we will explore how to integrate an open-source MCP server with Amazon Q and unlock its enhanced capabilities, creating seamless architecture diagrams generation. Take a look at this architectural diagram below – Isn’t it amazing? You will be surprised to know it was not created manually by draw.io or any other […]<\/p>\n","protected":false},"author":2171,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"iawp_total_views":42},"categories":[5877],"tags":[4782,8222,248,7637,8223],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/76803"}],"collection":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/users\/2171"}],"replies":[{"embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/comments?post=76803"}],"version-history":[{"count":15,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/76803\/revisions"}],"predecessor-version":[{"id":76845,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/posts\/76803\/revisions\/76845"}],"wp:attachment":[{"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/media?parent=76803"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/categories?post=76803"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.tothenew.com\/blog\/wp-json\/wp\/v2\/tags?post=76803"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}