mcp-server-hcp-terraform

mcp-server-hcp-terraform

HashiCorp Terraform Cloud/Enterprise API を操作するための MCP サーバー

概要

このプロジェクトは、HCP Terraform Cloud/Enterprise API と連携する MCP サーバーを提供します。MCP を通じて、Terraform モジュールの検索やモジュール情報の取得などの機能を利用できます。

前提条件

• Python 3.13+
• HCP Terraform Cloud/Enterprise アカウント
• アクセストークン

環境変数

使用する前に、次の環境変数を設定してください。

• HCP_TERRAFORM_TOKEN：HCP Terraform アクセストークン（必須）
• HCP_TERRAFORM_ORG：HCP Terraform の組織名（必須）
• HCP_TERRAFORM_BASE_URL：HCP Terraform のベース URL（任意、デフォルト：https://app.terraform.io）

機能

この MCP サーバーは、次の機能を提供します。

プライベートモジュールの検索

hcp_terraform_search_private_modules ツールを使用して、HCP Terraform Private Registry のモジュールを検索します。

パラメーター：

• query：検索クエリ
• provider（任意）：プロバイダーのフィルター（例：aws、gcp、azure）
• limit（任意）：結果の最大数（デフォルト：10）

モジュールの詳細を取得

hcp_terraform_get_module ツールを使用して、HCP Terraform Registry の特定のモジュールに関する詳細情報を取得します。

パラメーター：

• module_name：モジュール名
• provider：プロバイダー（例：aws、gcp、azure）
• registry_name（任意）：レジストリ名（private または public、デフォルト：private）
• namespace（任意）：モジュールの名前空間（指定しない場合は組織名を使用）

使用方法

{
  "globalShortcut": "",
  "mcpServers": {
    "HCP Terraform": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "path/to/mcp-server-hcp-terraform/server.py"
      ],
      "env": {
        "HCP_TERRAFORM_TOKEN": "paste_here",
        "HCP_TERRAFORM_ORG": "my_org"
      }
    }
  }
}

ライセンス

MIT License