mcp-server-hcp-terraform
About
An MCP server that integrates with the HCP Terraform Cloud/Enterprise API, allowing AI agents to search for Terraform modules and retrieve module details. It is designed for developers using Terraform Cloud/Enterprise who want to discover and inspect modules via MCP.
Details
- Author
- dulltz
- Downloads
- 312
- Categories
- Cloud Service
Jump to
- Search private Terraform modules in the Private Registry.
- Filter search results by provider (e.g., aws, gcp, azure).
- Limit search results to a configurable maximum.
- Retrieve detailed information about a specific module.
- Support for both private and public registry modules.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
mcp-server-hcp-terraformCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Set the environment variables HCP_TERRAFORM_TOKEN (required), HCP_TERRAFORM_ORG (required), and optionally HCP_TERRAFORM_BASE_URL. Then run the server using uv with the mcp CLI, referencing path/to/mcp-server-hcp-terraform/server.py. The server provides two tools: hcp_terraform_search_private_modules and hcp_terraform_get_module.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp-server-hcp-terraform": {
"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"
}
}
}
}
}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"
}
}
}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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
