# TerraVision

> TerraVision is an open-source MCP server for cloud and infrastructure. Draw AWS, Azure and GCP architecture diagrams from a prompt or Terraform code. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux, self-hosted
- **Website:** https://patrickchugh.github.io/terravision/
- **Repository:** https://github.com/patrickchugh/terravision
- **MCP Registry name:** io.github.patrickchugh/terravision
- **Categories:** cloud and infrastructure, developer tools
- **Listing updated:** 2026-11-14

## About

TerraVision works in both directions. Describe a design in plain words and the assistant returns a diagram in PNG, SVG or editable draw.io form, which you can refine by asking for changes such as adding a cache or tracing a request. Ask for the Terraform and it is written from the diagram. Point it at existing Terraform, local or on GitHub, and it draws what terraform plan says will be deployed.

It runs on your own computer and needs no cloud account access, so a production architecture can be drawn without production credentials and before anything exists. The README says only metadata is sent to LLMs. Diagrams place resources in their VPC, subnet, zone or resource group using official icons, and can be turned into a single interactive HTML page showing per-resource settings.

The registry lists a stdio package on PyPI. Graphviz and Git must be installed, plus uv in most setups. The README marks AWS support as fullest, with Azure and GCP partial, and notes the project is alpha software provided as-is.

## Features

- **Prompt to diagram:** Turn a plain-language design into an architecture diagram.
- **Terraform to diagram:** Draw what Terraform will deploy without cloud access.
- **Diagram to Terraform:** Write Terraform from a generated diagram.
- **Interactive HTML output:** Click resources to see encryption, ports and IAM settings.
- **CI redraw:** A GitHub Action redraws diagrams when Terraform changes.
- **Editable exports:** PNG, SVG and draw.io formats.

## Good for

- Document existing Terraform for an architecture review
- Sketch an AWS three-tier design and get its code
- Keep a repository's diagram in sync in CI
- Prepare an interactive view for a security audit

## Install

### Claude Code (Terminal)

```sh
claude mcp add terravision -- uvx terravision
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "terravision": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "terravision"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## FAQ

### Does it need cloud credentials?

No, it works from code alone on your machine.

### Which clouds are covered?

AWS most fully, with Azure and GCP partial per the README.

### What must be installed?

Graphviz and Git, plus uv for most clients.

### Is it free?

Yes, it is open source.

### Is it production ready?

The README describes it as alpha software provided as-is.

### Is TerraVision free?

Yes. TerraVision is open source, so you can use and self-host it for free.

### How do I add TerraVision to Claude Code?

Run this command in your terminal: claude mcp add terravision -- uvx terravision

### What are the best alternatives to TerraVision?

The closest alternatives to TerraVision are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/terravision
