Terraform MCP Server
Offizieller HashiCorp-MCP-Server für Terraform Registry, HCP Terraform, Workspaces und IaC-Automatisierung.
- Skill Road
- Terraform MCP Server
Beschreibung
Terraform MCP Server ist der offizielle Model-Context-Protocol-Server von HashiCorp für Terraform. Er verbindet MCP-fähige KI-Clients mit dem Terraform-Ökosystem, darunter Terraform Registry, HCP Terraform und Terraform Enterprise. Der direkte Produktlink führt zur HashiCorp-Developer-Dokumentation; der Quellcode liegt im Repository hashicorp/terraform-mcp-server. Für Skill Road ist der Eintrag wichtig, weil Infrastructure as Code eine typische Stelle ist, an der ein Agent nicht nur Text schreiben, sondern vorhandene Module, Provider, Workspaces, Variablen und Betriebsgrenzen verstehen muss. Ohne eine kontrollierte Quelle rät ein Modell schnell an Terraform-Syntax oder Organisationsstrukturen vorbei.
Terraform-Kontext für Agenten
Laut HashiCorp integriert der Server öffentliche Registry-APIs für Provider, Module und Policies sowie HCP Terraform beziehungsweise Terraform Enterprise. Er kann Workspaces auflisten und je nach freigegebenem Werkzeugset auch Workspace-Operationen unterstützen. Zusätzlich dokumentiert die README Ressourcen, Tool-Filterung und Metriken für Werkzeugaufrufe. Praktisch bedeutet das: Ein Coding-Agent kann beim Schreiben oder Prüfen von Terraform-Konfiguration gezielter nach passenden Providern, Modulen oder Workspace-Informationen fragen, statt nur aus Trainingswissen zu arbeiten. Das hilft besonders bei Teams, die standardisierte Module nutzen oder viele Workspaces verwalten.
Installation und Transportwege
Der dokumentierte lokale Einstieg läuft containerisiert, etwa mit docker run -i --rm hashicorp/terraform-mcp-server. Für Claude Code nennt die README einen direkten claude mcp add-Befehl; für Codex CLI und Cursor beziehungsweise VS Code gibt es ebenfalls Beispiele. Neben stdio unterstützt der Server Streamable HTTP für zentrale oder verteilte Setups. Genau dort werden die Sicherheitsentscheidungen wichtiger: Adresse, Token, erlaubte Ursprünge, TLS-Zertifikate, Rate-Limits und Organisations-Allowlist gehören auf Serverseite kontrolliert. Ein lokales Entwickler-Setup ist einfacher, eine zentrale Bereitstellung braucht dafür saubere Betriebsregeln.
Rechte, Tokens und Sicherheitsgrenzen
Der Server kann Terraform-Daten an MCP-Client und LLM weitergeben. HashiCorp weist selbst darauf hin, ihn nicht mit nicht vertrauenswürdigen MCP-Clients oder LLMs zu verwenden. In Streamable-HTTP-Setups darf TFE_ADDRESS laut README nicht von Clients per Header oder Query-Parameter gesetzt werden; der Server lehnt solche Versuche ab, damit Tokens nicht zu einer fremden Terraform-Adresse umgeleitet werden. Tokens sollten nie in Query-Parametern landen. Für zentrale Bereitstellungen sind TLS, MCP_ALLOWED_ORIGINS, Organisations-Allowlist und minimale Terraform-Rechte entscheidend. Ein Agent sollte nur die Toolsets bekommen, die für die jeweilige Aufgabe nötig sind.
Lizenz, Version und GitHub-Sterne
Das Repository steht unter MPL-2.0. Die GitHub-API meldete am 07.09.2026 exakt 1.522 Sterne; diese Zahl ist eine Momentaufnahme und kein Beleg für Sicherheit, Wartbarkeit oder Eignung. Als dokumentierte Container-Version wurde 1.3.0 verwendet. Der Server selbst ist quelloffen, aber die nutzbaren Funktionen hängen von Terraform Registry, HCP Terraform oder Terraform Enterprise sowie dem gewählten Client ab. Dieser Eintrag nennt keine festen Preise; maßgeblich sind die offiziellen Anbieterpläne und die eigene Infrastruktur. Besonders geeignet ist der Server für DevOps- und Plattformteams, die IaC-Arbeit in Claude Code, Codex oder Cursor nachvollziehbar an offizielle Terraform-Quellen anbinden wollen.
Für kleine Teams reicht oft ein lokales, nur lesendes Setup mit Registry-Werkzeugen. Größere Plattformteams sollten dagegen dokumentieren, welche Organisationen, Workspaces und Toolsets für Agenten freigegeben sind, damit Automatisierung nachvollziehbar bleibt.
Voraussetzungen
Docker, ein MCP-Client und für HCP Terraform oder Terraform Enterprise ein passend berechtigter API-Token.
Installationsanleitung
Was der Terraform MCP Server ist
Der Terraform MCP Server ist laut HashiCorp ein Model Context Protocol Server, der KI-Assistenten mit aktuellen Informationen aus der Terraform Registry sowie mit APIs von HCP Terraform und Terraform Enterprise verbindet. Terraform selbst ist ein Werkzeug für Infrastructure as Code: Infrastruktur wie Cloud-Ressourcen, Netzwerke, Datenbanken oder Zugriffsregeln wird dabei in Konfigurationsdateien beschrieben und anschließend reproduzierbar angewendet. Der MCP Server ergänzt diesen Workflow, indem er einem kompatiblen KI-Client strukturierte Werkzeuge zur Verfügung stellt, um Provider, Module, Policies, Arbeitsbereiche und private Registry-Inhalte abzufragen. Für Laien bedeutet das: Der KI-Assistent muss nicht nur aus seinem Trainingswissen raten, welche Terraform-Ressourcen oder Module existieren, sondern kann während der Arbeit gezielt Informationen aus offiziellen Terraform-Quellen und gegebenenfalls aus der eigenen HCP-Terraform-Organisation abrufen. Besonders nützlich ist das bei schnelllebigen Provider-APIs, bei denen veraltete Beispiele leicht zu falscher oder unsicherer Infrastruktur führen.
Schritt 1: Voraussetzungen
Laut offizieller README benötigt man einen MCP-fähigen KI-Client, etwa Claude Desktop, Claude Code, Cursor, VS Code, Amazon Q Developer, Kiro, Codex CLI oder Gemini-Erweiterungen, je nachdem welche Integration verwendet werden soll. Für den Containerbetrieb muss Docker installiert und gestartet sein. Der Server unterstützt zwei Transportarten: Stdio, also Kommunikation über Standard-Ein- und -Ausgabe, und Streamable HTTP, bei dem ein HTTP-Endpunkt wie /mcp bereitgestellt wird. Für reine Registry-Abfragen ist kein HCP-Terraform-Token zwingend notwendig, für Organisations-, Workspace- oder private Registry-Funktionen wird jedoch ein gültiger Terraform Enterprise beziehungsweise HCP Terraform API Token benötigt. Relevante Umgebungsvariablen sind unter anderem TFE_ADDRESS für die Adresse der Terraform-Enterprise- oder HCP-Terraform-Instanz, TFE_TOKEN für den API-Token, TRANSPORT_MODE für die Transportart sowie optionale TLS-, CORS- und Rate-Limit-Einstellungen für HTTP-Betrieb.
Schritt 2: Einrichtung Schritt für Schritt
Die konkrete Konfiguration hängt vom Client ab. Für lokale Clients wird meist ein MCP-Konfigurationsblock hinterlegt, der entweder ein Docker-Image startet oder das lokal installierte Binary mit passenden Argumenten ausführt. Im Stdio-Modus ist der Server für genau diesen Client-Prozess gedacht und bleibt relativ einfach abzusichern, weil keine Netzwerkadresse geöffnet wird. Für zentral bereitgestellte Umgebungen kann der Streamable-HTTP-Modus genutzt werden; dann werden Host, Port, Endpunkt, TLS-Zertifikat, erlaubte Ursprünge, Sitzungsmodus und Rate Limits per Umgebungsvariable gesetzt. HashiCorp dokumentiert außerdem Helm-Charts und Container-Builds für Deployment-Szenarien. Nach der Einrichtung sollte man mit einem harmlosen Werkzeug beginnen, etwa einer Provider- oder Modul-Suche in der öffentlichen Registry, bevor man Funktionen aktiviert, die auf HCP Terraform oder Terraform Enterprise schreiben oder Workspaces verändern können. Diese schrittweise Inbetriebnahme senkt das Risiko, dass ein falsch konfigurierter Client sofort weitreichende Aktionen ausführt.
Sicherheit und Trust Model
HashiCorp weist ausdrücklich darauf hin, dass der MCP Server je nach Anfrage Terraform-Daten an den MCP Client und das LLM weitergeben kann. Das betrifft nicht nur öffentliche Registry-Informationen, sondern bei angebundenem HCP Terraform auch Organisations-, Projekt-, Workspace-, Variablen- und Registry-Daten. Deshalb sollte der Server nur mit vertrauenswürdigen Clients und vertrauenswürdigen Sprachmodellen verwendet werden. Im HTTP-Modus gehören TLS, eine enge CORS-Konfiguration, Rate Limits und gegebenenfalls eine Organisations-Allowlist zu den wichtigsten Schutzmaßnahmen. Besonders sensibel ist Token Passthrough für zentralisierte Deployments: Der Server kann Anfragen im Auftrag verschiedener Nutzer weiterleiten, was nur dann sicher ist, wenn Header, vertrauenswürdige Proxy-Hops und Client-IP-Weitergabe sauber kontrolliert werden. API-Token sollten minimal berechtigt sein, regelmäßig rotiert werden und niemals in Repositorys oder Prompt-Texten auftauchen.
Für wen der Server sinnvoll ist
Der Terraform MCP Server ist vor allem für Teams sinnvoll, die Terraform bereits professionell einsetzen und KI-Assistenten als unterstützendes Werkzeug beim Schreiben, Reviewen oder Erkunden von Infrastrukturcode nutzen wollen. Er ist weniger ein Anfängerwerkzeug, das Terraform ersetzt, sondern eher eine Schnittstelle, die offizielle Terraform-Informationen in den Arbeitskontext eines Assistenten bringt. Gegenüber generischen Websuchen hat er den Vorteil, dass er direkt auf Terraform Registry und HCP Terraform ausgerichtet ist und strukturierte Werkzeuge statt frei interpretierter Webseiten liefert. Gegenüber eigenen Skripten spart er Integrationsaufwand, verlangt aber auch Vertrauen in die MCP-Client-Kette. In produktiven Umgebungen sollte jede vom Modell vorgeschlagene Terraform-Änderung weiterhin durch terraform plan, Code Review, Policy Checks und gegebenenfalls manuelle Freigabe laufen.
docker run -i --rm hashicorp/terraform-mcp-server
Authentifizierung
Für Registry-Funktionen teils ohne Token; HCP Terraform/Terraform Enterprise benötigt TFE_TOKEN und eine feste TFE_ADDRESS.
Benötigte Zugriffsrechte
Rechte folgen dem Terraform-Token und den aktivierten Toolsets. Toolsets und einzelne Tools lassen sich filtern.
Übertragene oder gespeicherte Daten
Der Server ruft Terraform-Registry- und HCP/TFE-APIs ab und gibt Ergebnisse an den MCP-Client zurück.
Sicherheitsrisiken
Breite Tokens, ungeprüfte Clients oder zentrale HTTP-Endpunkte ohne TLS/Origin-Kontrolle können Infrastrukturinformationen offenlegen oder verändern.
Lizenz und Kosten
- Lizenz
- MPL-2.0
- Kosten
- kostenlos
Der Server ist quelloffen. Kosten richten sich nach Terraform-Produkten, HCP/TFE-Nutzung, Infrastruktur und dem gewählten KI-Client.
Alternativen
Noch nicht erfasst.
Auf einen Blick
- Anbieter
- HashiCorp
- Status
- Offizieller Server
- Betriebsart
- Lokal und Remote
- Aktuelle Version
- 1.3.0
- GitHub-Sterne
- 1,562
- Zuletzt geprüft
- 07.09.2026
Repository und Dokumentation
Kategorien
Unterstützte Clients
Passende Ratgeber
Anleitungen und Hintergrund, die zu diesem Eintrag passen.