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