TerraVision

社区

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

分类: 开发工具第 176 / 438
Stars: ★ 1.7k 非常热门
传输方式: stdio（本地进程）
运行环境: Python 3.10+ · 预编译二进制
凭据: 可选 API Key
许可证: AGPL-3.0
最近提交: 4 天前

56FMRS · C

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

最强项 · 安全与权限 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

14/20

维护活跃度

11/20

文档质量

13/20

安装易用性

10/20

查看各项评分依据

可靠性 8/20: 清单明确声明通过 uvx、PyPI 和 stdio 启动 MCP 子命令，启动路径基本连贯；README 也说明了 MCP 用途。但未提供工具列表、工具参数、初始化/工具列表握手证据、MCP 测试或错误处理实现，因此无法验证握手和实际行为，按静态校准扣分。
安全与权限 14/20: README 声明本地运行、无需云访问且 Terraform 源码不会离机；预生成 plan 模式也不需要云凭证。可选的 Bedrock 和 restapi 后端会向外部服务发送元数据和摘要图，并使用 AWS 凭证或 API 密钥，但 MCP 工具级权限、用户确认、网络范围和敏感数据处理未在给定材料中明确，因此扣分；未见红线风险证据。
维护活跃度 11/20: 项目未归档，具有明确 GitHub 仓库、AGPL-3.0 许可证、版本 0.46.3、CI/lint-and-test 徽章、问题入口和贡献指南链接，表明存在基本维护渠道。但给定材料没有提交频率、发布历史、依赖更新、漏洞响应流程或维护者承诺的可核查证据，因此扣分。
文档质量 13/20: README 覆盖安装前置条件、基本用法、Terraform plan 输入、输出格式、云厂商范围、AI 后端、数据边界、CI/CD、故障排查和文档入口，并提供多个示例。缺少 MCP 工具名称与参数、主流客户端连接配置、权限模型、限制和成本细节；部分细节仅通过外部文档链接指向，故未给满分。
安装易用性 10/20: manifest 提供 PyPI 包、版本、uvx 运行提示和 stdio 传输；README 给出 Python 3.10+、Terraform、Graphviz、Git 等前置条件及 CLI 示例。可是没有主流 MCP 客户端配置示例，且依赖较多、MCP 专用连接步骤和平台兼容性证据不足，因此属于可行但偏手工的安装路径。

静态评测 · 未实际运行收录于 2026-08-14

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件执行命令或代码访问网络

适合谁

使用 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+ · 预编译二进制

TV_RESTAPI_KEY 可选密钥可选：上述 restapi 端点的 API 密钥（机密），仅在 --ai-annotate restapi 时使用。

其他可选配置项（2 个）

TV_RESTAPI_URL 可选可选：OpenAI 兼容 AI 注释端点的 URL，仅在 --ai-annotate restapi 时使用；见文档 Annotations Guide。

TV_RESTAPI_MODEL 可选可选：restapi 端点使用的模型名称，仅在 --ai-annotate restapi 时使用。

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

验证是否装好

安装 uvx 后在客户端中配置 uvx --from terravision[mcp] terravision mcp，连接后让 AI 为一个 Terraform 目录生成架构图；若客户端能调用该服务器并输出 architecture.png 或交互式 HTML，即说明安装成功。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

为 ./path-to-your-terraform 的 Terraform 代码生成一张云架构图
用官方 AWS 图标画出 tests/fixtures/aws_terraform/eks_automode 的架构图并打开
把 https://github.com/patrickchugh/terraform-examples.git//aws/wordpress_fargate 的 Terraform 生成交互式 HTML 架构图
从这份 Terraform 生成一个简化的高层架构图，不含 VPC 和子网

使用场景

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

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

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

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

详细介绍

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