What is Mcp Server Hcp Terraform

mcp-server-hcp-terraform is an MCP server designed to integrate with the HashiCorp Terraform Cloud/Enterprise API, allowing users to access and manage Terraform modules effectively.

Use cases

Use cases include searching for specific Terraform modules in the HCP Terraform Private Registry, retrieving details about modules for deployment, and managing Terraform resources in a collaborative environment.

How to use

To use mcp-server-hcp-terraform, set the required environment variables such as HCP_TERRAFORM_TOKEN and HCP_TERRAFORM_ORG. Then, run the server using the provided command structure in the README.

Key features

Key features include searching for private Terraform modules, retrieving detailed module information, and filtering results by provider and other parameters.

Where to use

mcp-server-hcp-terraform is used in cloud infrastructure management, DevOps practices, and any environment where Terraform is utilized for infrastructure as code.

mcp-server-hcp-terraform

MCP server for working with HashiCorp Terraform Cloud/Enterprise API

Overview

This project provides a MCP server that integrates with the HCP Terraform Cloud/Enterprise API. Through MCP, you can access features such as searching for Terraform modules and retrieving module information.

Prerequisites

• Python 3.13+
• HCP Terraform Cloud/Enterprise account
• Access token

Environment Variables

Set the following environment variables before use:

• HCP_TERRAFORM_TOKEN: HCP Terraform access token (required)
• HCP_TERRAFORM_ORG: HCP Terraform organization name (required)
• HCP_TERRAFORM_BASE_URL: HCP Terraform base URL (optional, default: https://app.terraform.io)

Features

This MCP server provides the following features:

Search Private Modules

Use the hcp_terraform_search_private_modules tool to search for modules in the HCP Terraform Private Registry.

Parameters:

• query: Search query
• provider (optional): Provider filter (e.g., aws, gcp, azure)
• limit (optional): Maximum number of results (default: 10)

Get Module Details

Use the hcp_terraform_get_module tool to retrieve detailed information about a specific module from the HCP Terraform Registry.

Parameters:

• module_name: Name of the module
• provider: Provider (e.g., aws, gcp, azure)
• registry_name (optional): Registry name (private or public, default: private)
• namespace (optional): Module namespace (uses organization name if not specified)

Usage

{
  "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"
      }
    }
  }
}

License

MIT License