patrickchugh/terravision

它解决了什么问题

TerraVision 自动化创建适用于 AWS、Azure 和 Google Cloud 的专业云架构图。它消除了在 Lucidchart 或 Visio 等工具中手动绘制图表的需要，确保可视化文档与实际基础设施代码 (Terraform) 保持完美同步，或者可以通过 AI 助手根据简单的英语描述即时生成。

工作原理

TerraVision 作为本地工具运行，可以通过模型上下文协议 (MCP) 或插件集成到 AI 助手（如 Claude、ChatGPT 和 Cursor）中。它主要通过两个方向工作：

1. 设计到代码：AI 助手接收自然语言描述，生成 JSON 图，然后 TerraVision 将其渲染成图表。随后，助手可以根据该设计编写相应的 Terraform 代码。
2. 代码到图表：TerraVision 分析 terraform plan 的输出，以生成正在部署的资源、VPC、子网和区域的准确可视化表示。

它使用 Graphviz 进行渲染，并可以将图表导出为 PNG、SVG、可编辑的 draw.io 文件或交互式 HTML 页面。

适用人群

使用 Terraform 管理基础设施，并希望在无需手动操作的情况下维护准确、专业的架构图的云架构师、DevOps 工程师和开发人员。

亮点

• AI 原生集成：作为 Claude Desktop、ChatGPT 和其他兼容 MCP 的客户端的扩展/插件运行。
• 可证明的准确性：直接从 Terraform 代码生成图表，使代码成为单一事实来源。
• 本地且安全：完全在用户机器上运行，无需云访问，也无需上传代码。
• 多云支持：提供 AWS、Azure 和 GCP 的官方图标和分组约定。
• CI/CD 自动化：包含一个 GitHub Action，可在 Terraform 代码更改时自动重新绘制图表。
• 交互式输出：支持可点击的 HTML 图表，用于安全审计和文档记录。