mcp-server-hcp-terraform

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