← 返回目录

TerraVision

社区

将 Terraform 代码自动转换为专业云架构图。

GitHub 源仓库 ↗

★ 1.6k Stars 分类 · 开发工具非常热门源版本 69bae0199bf2

56FMRS · C

可靠性

8/20

安全与权限

14/20

维护活跃度

11/20

文档质量

13/20

安装易用性

10/20

资料显示 TerraVision 是一个 AGPL-3.0 开源、本地运行的 Terraform 架构图生成工具，并提供 stdio MCP 启动方式。它支持 AWS 的完整资源覆盖以及 Azure、GCP 的核心服务，但资料未提供具体 MCP 工具名称或客户端兼容性信息。

查看 FMRS 评分方法 →

TerraVision 是一个本地运行的 MCP 服务器，可根据 Terraform 代码或预生成的 Terraform plan 生成云架构图，支持 AWS、Google Cloud 和 Azure，并使用官方云服务图标。输出可包括交互式 HTML、PNG、SVG、PDF 和可编辑的 draw.io 文件。

工具能力

暂未整理工具清单。

安装接入

使用 uvx 启动：uvx --from terravision[mcp] terravision mcp。运行环境要求 Python 3.10+；常规 Terraform 处理还需要 Terraform 1.x、Graphviz 和 Git。

选型与风险

适合谁

使用 Terraform 管理基础设施的开发者和平台工程团队
需要维护多云架构文档的团队
希望本地处理基础设施代码的用户

不适合谁

不使用 Terraform 的项目
需要完整 Azure 或 GCP 资源覆盖的场景
需要服务器端云资源发现或远程基础设施管理的用户

所需权限

需要读取本地 Terraform 项目、变量文件以及可选的 plan JSON 和 graph DOT 文件
常规运行需要本地 Terraform、Graphviz 和 Git 环境
使用 AWS Bedrock AI 注释时需要 AWS 凭据

风险与副作用

Azure 和 GCP 目前仅提供核心服务的部分支持，图表可能不完整
启用 Bedrock 或其他 REST API AI 注释时，元数据和摘要图会发送到相应的模型服务；README 声明不会发送 .tf 源文件
生成的图表依赖 Terraform 代码、plan 或 graph 输入的准确性，不能替代基础设施验证

常见排障

确认 Python 版本为 3.10 或更高
确认 Terraform 1.x、Graphviz 和 Git 已安装并可执行
使用预生成 plan 时，同时提供 plan JSON 和 graph DOT 文件
检查 Terraform workspace、varfile 和源目录是否正确
使用 AI 注释时检查对应后端配置及 AWS 凭据或 REST API 环境变量

使用场景

根据 Terraform 基础设施生成架构图

在 CI/CD 中自动更新架构文档

生成可交互的离线 HTML 架构图

导出可编辑的 draw.io 架构文件

支持客户端

暂未确认支持的客户端。