TerraVision

listing.by

Generate AWS, Azure and GCP architecture diagrams with official icons from a description, a JSON graph or Terraform code.

state.local.long (state.local.title)listing.badge.runs_with

listing.install

listing.local.explain

uvx terravision

listing.local.needs listing.local.note

listing.share.h

listing.share.p_local

mcp.tc/i/terravision

listing.about

TerraVision draws cloud architecture diagrams in the official AWS, Azure and Google Cloud icon style, placing each resource in its VPC, subnet, zone or resource group. Diagrams can come from a plain-language description, a JSON graph or Terraform code, and Terraform can be written back from a diagram. Output includes PNG, SVG and editable draw.io files.

It runs locally over stdio through the PyPI package terravision, started with uvx. Graphviz and Git must be installed, and Terraform is needed only to draw from Terraform code. No cloud access, sign-in or API key is required. The project is open source under AGPL-3.0.

listing.can

  • Draw AWS, Azure and GCP architecture diagrams from a text description
  • Generate diagrams from local or GitHub Terraform code
  • Build diagrams from a JSON graph
  • Export PNG, SVG and editable draw.io files
  • Refine a diagram by asking for added services
  • Write Terraform from a diagram

listing.tools

listing.notools.local

listing.prompts

  • Draw an AWS three-tier app with CloudFront, ECS Fargate behind an ALB and RDS Multi-AZ

  • Draw the architecture my Terraform in ./infra deploys

  • Add ElastiCache to the diagram and show how a request flows

  • Generate Terraform from this Azure hub-and-spoke diagram

listing.setup.h

listing.setup.local

Claude Code

  1. Run this in a terminal, in your project folder:
claude mcp add --transport stdio terravision -- uvx terravision
  1. Start Claude Code and type /mcp. terravision should show as connected.

Add --scope user to make it available in every project.

Claude Desktop

  1. Open Settings → Developer → Edit Config. It opens claude_desktop_config.json. Add:
claude_desktop_config.json
{
  "mcpServers": {
    "terravision": {
      "command": "uvx",
      "args": [
        "terravision"
      ]
    }
  }
}
  1. Save the file and restart Claude Desktop.

Needs uv (Python) on your computer. The file lives in ~/Library/Application Support/Claude/ on macOS and %APPDATA%\Claude\ on Windows.

Cursor

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

mcp.json
{
  "mcpServers": {
    "terravision": {
      "command": "uvx",
      "args": [
        "terravision"
      ]
    }
  }
}

Needs uv (Python) on your computer.

VS Code

Or from a terminal:

code --add-mcp '{"name":"terravision","type":"stdio","command":"uvx","args":["terravision"]}'

Or commit it to the repo in .vscode/mcp.json:

.vscode/mcp.json
{
  "servers": {
    "terravision": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "terravision"
      ]
    }
  }
}

Needs uv (Python) on your computer.

Devin Desktop

  1. Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %APPDATA%\devin\mcp_config.json (Windows):
mcp_config.json
{
  "mcpServers": {
    "terravision": {
      "command": "uvx",
      "args": [
        "terravision"
      ]
    }
  }
}
  1. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf.

Codex

codex mcp add terravision -- uvx terravision

Or edit ~/.codex/config.toml directly:

config.toml
[mcp_servers.terravision]
command = "uvx"
args = ["terravision"]

Needs uv (Python) on your computer.

Gemini CLI

gemini mcp add terravision uvx terravision

This adds it to the current project. Add -s user to use it everywhere.

Any client

Most clients that start local servers accept this shape:

{
  "mcpServers": {
    "terravision": {
      "command": "uvx",
      "args": [
        "terravision"
      ]
    }
  }
}

Zed puts servers under context_servers in its settings, with the same command, args and env fields.

Needs uv (Python) on your computer.

listing.faq

Can I paste mcp.tc/i/terravision into my MCP client?

No. TerraVision runs on your own computer, started by your client, so it has no web address to connect to. The quick link is the page to share; the install command is uvx terravision.

Does TerraVision need an API key?

No. It doesn't declare any keys or environment variables. It runs with your user account's permissions, so check what its tools can reach.

Is TerraVision a remote or a local server?

Local. Your client starts it as a process on your computer with uvx terravision, which needs uv (Python).

What can TerraVision do?

You can draw AWS, Azure and GCP architecture diagrams from a text description, generate diagrams from local or GitHub Terraform code and build diagrams from a JSON graph.

Which clients can use it?

Any client that starts local servers: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed and others. claude.ai and ChatGPT only connect to remote servers.

Who wrote this page?

mcp.tc's robot read TerraVision's public metadata (its package and repository pages), and an AI model drafted the text from it. A person reviews anything the checks can't confirm. The text can still be wrong, so if you spot a mistake, use Report this listing on this page.

listing.em.h

listing.em.lead_local listing.em.how

listing.em.badge

em.prev_lightem.prev_dark
Markdown
[![TerraVision on mcp.tc](https://mcp.tc/i/terravision/badge.svg)](https://mcp.tc/i/terravision)
HTML
<a href="https://mcp.tc/i/terravision"><img src="https://mcp.tc/i/terravision/badge.svg" alt="TerraVision on mcp.tc" height="20"></a>

listing.em.badge_note

listing.em.widget

HTML
<script src="https://mcp.tc/w/terravision.js" async></script>

listing.em.widget_note

iframe

HTML
<iframe src="https://mcp.tc/embed/terravision" title="TerraVision on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

listing.em.iframe_note

JSON

listing.em.json_local

https://mcp.tc/i/terravision.json

listing.em.fields

listing.disclaimer_checked