TerraVision MCP server

TerraVision

<!-- mcp-name: io.github.patrickchugh/terravision -->

Turn Terraform code into professional cloud architecture diagrams that stay in sync with your infrastructure — automatic, secure, living documents

📖 Full documentation site →

Watch a 4-Minute Intro

What is TerraVision?

TerraVision automatically converts your Terraform code into professional-grade cloud architecture diagrams using the official AWS, GCP, and Azure icon sets. Your diagrams stay in sync with your infrastructure — no more outdated Visio, draw.io or Lucidchart files.

Why TerraVision?

• ✅ Always up-to-date — diagrams generated directly from your Terraform code
• ✅ 100% client-side — no cloud access required, runs locally, your code never leaves your machine
• ✅ CI/CD ready — automate diagram updates on every PR merge
• ✅ Free & open source — no expensive diagramming tool licenses
• ✅ Multi-cloud — AWS (full), GCP, and Azure (core services)
• ✅ Interactive HTML output — clickable nodes, pan/zoom, search, animated data flow
• ✅ Editable draw.io export — open in draw.io, Lucidchart, or any mxGraph editor
• ✅ Optional AI annotations — labels, titles, and flow sequences from Ollama (local) or AWS Bedrock
• ✅ Terragrunt compatible — auto-detects single- and multi-module Terragrunt projects
• ✅ MCP server — let AI agents generate diagrams from your Terraform, see the guide

Supported Cloud Providers

Quick Start

Install

pipx install terravision   # or: pip install terravision if in a virtual env

You also need Python 3.10+, Terraform 1.x, Graphviz, and Git. See the Installation Guide for platform-specific instructions, Docker, and Nix.

Generate your first diagram

git clone https://github.com/patrickchugh/terravision.git
cd terravision

# EKS cluster example
terravision draw --source tests/fixtures/aws_terraform/eks_automode --show

# Azure VM scale set
terravision draw --source tests/fixtures/azure_terraform/test_vm_vmss --show

# From a public Git repo (note the // for subfolder)
terravision draw --source https://github.com/patrickchugh/terraform-examples.git//aws/wordpress_fargate --show

That's it — your diagram is saved as architecture.png and opens automatically.

Generate an interactive HTML diagram

terravision visualise --source ./path-to-your-terraform --show

Shortened. The full README is on GitHub.