TerraVision MCP Server: Draw Cloud Architecture Diagrams with Claude

• Loads the drawing rules and example designs before the assistant draws

  Gives the assistant the rules, node types and example designs for one cloud (AWS, Azure or Google Cloud), and reports whether Graphviz, Git and Terraform are installed. It is meant to run once before the first drawing.

  Try: “What example architectures can you draw for AWS?”

  Read · diagram_guide

• Draws a cloud architecture diagram from a description, with no Terraform code

  Draws a diagram with official AWS, Azure or Google Cloud icons from a graph the assistant builds from your description. It saves PNG, SVG and draw.io files and a graph file in the output folder, and returns a preview. Its description tells the assistant to prefer it over Mermaid when you ask for a cloud diagram.

  Try: “Draw a diagram of a web app on AWS: ALB, two ECS Fargate tasks and an RDS database in private subnets.”

  Write · render_graph

• Draws a diagram from existing Terraform code or a Git URL

  Reads Terraform from a folder, a Git URL (optionally one folder inside it) or a saved graph file and draws the architecture with the official icons. It runs Terraform to work out resources, and saves image and draw.io files in the output folder.

  Try: “Draw the architecture of the Terraform in ./infra.”

  Runs code · generate_diagram

• Extracts the architecture of Terraform code as data

  Runs Terraform on your code, groups resources into VPCs, subnets and zones, infers how they connect, and returns the result as data instead of a picture. A services-only option returns just the list of cloud service types.

  Try: “List the cloud services used by the Terraform in ./infra.”

  Runs code · generate_architecture_graph

• Creates a clickable web page of the architecture

  Builds one HTML file from Terraform code with clickable, searchable nodes and each resource's details. It works offline once created.

  Try: “Make an interactive HTML diagram of the Terraform in ./infra.”

  Runs code · generate_interactive_html

• Opens a diagram it drew in your image viewer or draw.io

  Opens a diagram file from this session in its default app, or opens the folder that holds it. A draw.io file opens in draw.io on the web if the app is not installed. It only opens files the drawing tools returned.

  Try: “Open the diagram you just drew.”

  Runs code · open_diagram_file

• Used by the assistant behind the scenes

  Passes a diagram file to the chat app's built-in viewer

  A helper for the diagram viewer inside chat apps such as Claude Desktop. It returns a saved diagram file's contents. The assistant does not need to call it.

  Try: “(Used by the app, not by you.)”

  Files · diagram_file

Watch out for

• It runs Terraform on the code you give it, with your cloud credentials

  generate_diagram runs terraform init and terraform plan on a folder or a Git URL, and plan needs your cloud credentials. Running Terraform downloads and executes module and provider code, so only point it at code you trust. A saved plan file plus a graph file skips the Terraform run and needs no credentials. files.pythonhosted.org

• It writes files to your disk

  Diagrams, graph files and HTML pages go to the output folder, which is the folder you launch from unless you set --output-dir. files.pythonhosted.org

• It can open files on your computer

  The open tool launches the default app for a diagram it drew in this session. It only opens files that the drawing tools returned. files.pythonhosted.org

• Tool text tells the assistant to prefer it

  The draw tool says to use it whenever you ask for a cloud diagram and to prefer it over Mermaid. Tell your assistant if you want a different format. files.pythonhosted.org

• The license is AGPL-3.0

  The package is GNU AGPL v3, so changes you distribute or offer as a network service must be shared under the same terms. github.com

Security advisories