patrickchugh/terravision

解決する課題

TerraVisionは、AWS、Azure、Google Cloud向けのプロフェッショナルなクラウドアーキテクチャ図の作成を自動化します。LucidchartやVisioなどのツールで手動で図を描く必要がなくなり、視覚的なドキュメントが実際のインフラコード（Terraform）と完全に同期された状態を維持したり、AIアシスタントを介して平易な英語の説明から即座に生成したりすることが可能です。

仕組み

TerraVisionは、Model Context Protocol (MCP) を介してAIアシスタント（Claude、ChatGPT、Cursorなど）に統合したり、プラグインとして利用したりできるローカルツールとして動作します。主に以下の2つの方向で機能します。

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自動化: Terraformコードが変更されるたびに自動的に図を再描画するGitHub Actionが含まれています。
• インタラクティブな出力: セキュリティ監査やドキュメント作成用に、クリック可能なHTML図をサポートしています。