Terraform MCP Server

Terraform MCP Server

Terraform MCPサーバーは、Terraform Registry APIと最新のAIワークフローを接続するプロトコルサーバーです。これにより、VS CodeやClaude Desktopなどのエージェント対応の開発環境内で、Terraformプロバイダーやモジュールの自動探索、分析、統合が可能になります。

Author: hashicorp


プロトコルを表示

Terraform MCPサーバーとは？

Terraform MCPサーバーは、Infrastructure as Codeのワークフローと強力なAIエージェントを結びつけます。これにより、Terraform Registryのデータと機能を標準化されたMCPツールを介して公開します。開発者はプロバイダーの発見、モジュールの探索、文書の取得を自動化でき、IaCの開発を効率化し、知能を持つエージェントがTerraformリソースと直接対話できるようにします。

Terraform MCPサーバーの設定方法

  • Dockerを使用する場合: hashicorp/terraform-mcp-serverイメージを指すMCPサーバーの設定を開発環境に追加します。VS Codeの例: 
    {
  "mcp": {
    "servers": {
      "terraform": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "hashicorp/terraform-mcp-server"
        ]
      }
    }
  }
}
  • ソースからの場合: 公式リポジトリをクローンし、make buildを実行して、サーバー設定をローカルでビルドしたバイナリに向けます。 
    {
  "mcp": {
    "servers": {
      "terraform": {
        "command": "/path/to/terraform-mcp-server",
        "args": ["stdio"]
      }
    }
  }
}
  • Claude Desktopで: 設定内のmcpServersキーを使用し、同じDocker（またはローカルバイナリ）コマンドオプションを指定します。

Terraform MCPサーバーの使用方法

  1. 開発環境を開始します（VS Code、Claude Desktop、またはその他のエージェント対応ツール）。
  2. 上記の手順に従って、Terraform用のMCPサーバーを設定します。
  3. AIエージェントやLLM対応チャットを介して対話します — プロバイダーのクエリ、モジュールの検索、文書の取得を、手動でブラウザを開くことなくTerraform Registryから直接行います。
  4. 必要に応じて、他の人があなたの環境設定を使えるように.vscode/mcp.jsonを共有します。
  5. 使用可能なツールを呼び出します（searchModulesやgetProviderDocsなど）選択したホスト環境のインターフェースを利用して、迅速で文脈に富んだInfrastructure as Codeのガイダンスを得ます。

主な機能

  • プロバイダーやモジュールに関するライブデータのためのTerraform Registry APIとの直接統合
  • 発見、取得、探索を自動化するためにMCPエンドポイントとしてツールを公開
  • VS Code、Claude Desktop、あらゆるMCP対応ホストとのシームレスな相互運用性
  • コンテナ化またはローカルソースのデプロイをサポート
  • 簡単なAI消費のために生の構造化文書をマークダウン形式で提供
  • 最小限の手動設定でAI支援のIaCワークフローを促進
  • セキュリティ、コンプライアンス、自動化インフラの分析におけるベストプラクティスと強く一致

ユースケース

  • IDE内からプロジェクトに関連するTerraformモジュールの検索と発見を自動化します。
  • プロバイダーリソースまたはデータソースの文書を迅速に抽出、分析、または要約します。
  • コーディング環境を離れずにモジュールに関する詳細な入力、出力、および例の情報を取得します。
  • リッチでリアルタイムのレジストリデータを提供することで、AIエージェントがInfrastructure as Codeを推薦、レビュー、またはリファクタリングできるようにします。
  • 利用可能なプロバイダーを探索し、コスト、セキュリティ、およびコンプライアンスの結果を向上させるために最適なモジュール選択を検証します。

FAQ

Q1: Terraform MCPサーバーを使用するのにDockerは必要ですか？
A: Dockerはほとんどのユーザーにとって最も簡単な方法ですが、Goがインストールされていれば、ソースからサーバーをビルドして実行することもできます。

Q2: MCP経由でアクセスする際、Terraform Registryのデータは安全ですか？
A: サーバーは、開発環境のセキュリティプラクティスを尊重するように設計されており、機密なインフラ情報を外部に公開せずに完全にローカルで実行できます。

Q3: Terraform MCPサーバーの設定をチームメイトと共有できますか？
A: はい、.vscode/mcp.jsonファイルに設定を含めることで、コードベースやチーム全体で簡単に共有できます。

Q4: 現在サポートされている環境はどれですか？
A: 公式文書はVS CodeとClaude Desktopをカバーしていますが、原則としてあらゆるMCP対応のホストを使用できます。

Q5: 出力や推奨はどのくらいの頻度で更新されますか？
A: 結果はクエリに基づいて動的に生成されるため、Terraform Registryの変更やサーバーの更新は直ちに反映されます。