← Back to directory
T

TerraVision

Community
Automatically turn Terraform code into professional cloud architecture diagrams.
GitHub source repository ↗
★ 1.6k Stars Category · Dev Tools Very popular Source revision 69bae0199bf2
56FMRS · C
Reliability
8/20
Security and permissions
14/20
Maintenance
11/20
Documentation
13/20
Setup experience
10/20

The supplied materials identify TerraVision as an AGPL-3.0 open-source, locally run Terraform diagram generator with stdio MCP startup support. It offers full AWS coverage and core-service support for Azure and GCP, but the materials do not provide MCP tool names or client compatibility information.

Read the FMRS scoring method →

TerraVision is a locally run MCP server that generates cloud architecture diagrams from Terraform code or pre-generated Terraform plans. It supports AWS, Google Cloud, and Azure, uses official cloud-service icon sets, and can produce interactive HTML, PNG, SVG, PDF, and editable draw.io outputs.

Tools

The tool list has not been reviewed yet.

Setup

Start it with uvx: uvx --from terravision[mcp] terravision mcp. The environment requires Python 3.10+; normal Terraform processing also requires Terraform 1.x, Graphviz, and Git.

Fit and risk

Best for

  • Developers and platform engineering teams using Terraform
  • Teams maintaining multi-cloud architecture documentation
  • Users who want local processing of infrastructure code

Not for

  • Projects that do not use Terraform
  • Workloads requiring complete Azure or GCP resource coverage
  • Users seeking server-side cloud discovery or remote infrastructure management

Required permissions

  • It needs to read local Terraform projects, variable files, and optionally plan JSON and graph DOT files
  • Normal operation requires local Terraform, Graphviz, and Git installations
  • AWS credentials are needed when using AWS Bedrock for AI annotations

Risks and side effects

  • Azure and GCP currently have partial support limited to core services, so diagrams may be incomplete
  • When Bedrock or another REST API annotation backend is enabled, metadata and a summary graph are sent to the configured model service; the README states that .tf source files are not sent
  • Generated diagrams depend on the accuracy of the Terraform, plan, or graph inputs and do not replace infrastructure validation

Troubleshooting

  1. Confirm that Python 3.10 or newer is installed
  2. Confirm that Terraform 1.x, Graphviz, and Git are installed and available
  3. When using a pre-generated plan, provide both the plan JSON and graph DOT files
  4. Check the Terraform workspace, varfile, and source directory
  5. For AI annotations, verify the selected backend configuration and AWS credentials or REST API environment variables

Use cases

Generate architecture diagrams from Terraform infrastructure
Automatically update architecture documentation in CI/CD
Create interactive, offline HTML architecture diagrams
Export editable draw.io architecture files

Supported clients

Supported clients have not been confirmed yet.