Terraform MCP Server

Что умеет сервер

Terraform MCP Server выпускает HashiCorp. Он связывает AI-клиент с публичным Terraform Registry и с API HCP Terraform и Terraform Enterprise. Без токена доступны инструменты реестра: поиск и чтение документации провайдеров (ресурсы, источники данных, функции, руководства), поиск модулей с их входами, выходами и примерами, политики Sentinel, а также запрос последней версии провайдера или модуля. Кроме инструментов сервер отдаёт модели справочные материалы: официальный style guide Terraform и руководство по разработке модулей.

Если задать TFE_TOKEN, добавляются инструменты для HCP Terraform и Terraform Enterprise: организации, проекты, команды, рабочие пространства, переменные и наборы переменных, теги, версии состояния, Stacks, а также запуски с логами плана и применения и поиск в частных реестрах модулей и провайдеров. Эти наборы инструментов регистрируются только при действующем токене.

Когда использовать

Подключайте сервер, когда хотите, чтобы модель писала HCL по актуальной документации, а не по памяти: как настроить ресурс провайдера, какой модуль выбрать для кластера Kubernetes, какая версия провайдера свежая. С токеном сервер полезен командам на HCP Terraform: попросить найти упавший запуск, прочитать лог плана, сравнить переменные в рабочих пространствах или создать рабочее пространство по описанию.

Ограничения и безопасность

Опасные операции выключены по умолчанию. Применение, отмена и сброс запуска, удаление рабочих пространств, проектов и команд, принудительная разблокировка рабочего пространства работают только при ENABLE_TF_OPERATIONS=true. С этим флагом у create_run появляются режимы auto_approve и is_destroy, и документация прямо советует обращаться с ними осторожно, потому что они могут навсегда изменить или уничтожить инфраструктуру.

В README есть три предупреждения. Сервер может передать данные Terraform клиенту и модели, поэтому не используйте его с недоверенными клиентами и моделями. Ответы формируются динамически и зависят от запроса, модели и клиента, их нужно проверять на соответствие требованиям безопасности, стоимости и комплаенса. Токен определяет, что агент увидит и сделает в HCP Terraform, так что выдавайте токен с минимально нужными правами. Для запуска в контейнере нужен Docker.

Claude Code

Локальный сервер (stdio) через Docker:

claude mcp add terraform -s user -t stdio -- docker run -i --rm hashicorp/terraform-mcp-server

Удалённый вариант (streamable-http): сначала запустите сервер, затем добавьте его в Claude Code.

# Run server (example)
docker run -p 8080:8080 --rm -e TRANSPORT_MODE=streamable-http -e TRANSPORT_HOST=0.0.0.0 hashicorp/terraform-mcp-server

# Add to Claude Code
claude mcp add --transport http terraform http://localhost:8080/mcp

Claude Desktop

Для версии 0.3.0 и новее. Подставьте адрес и токен HCP Terraform или Terraform Enterprise (без них доступны только инструменты публичного реестра).

{
  "mcpServers": {
    "terraform": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "TFE_ADDRESS=<<PASTE_TFE_ADDRESS_HERE>>",
        "-e", "TFE_TOKEN=<<PASTE_TFE_TOKEN_HERE>>",
        "hashicorp/terraform-mcp-server:1.3.0"
      ]
    }
  }
}

Cursor

Добавьте в ~/.cursor/mcp.json или через Settings, Cursor Settings, MCP:

{
  "mcpServers": {
    "terraform": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "TFE_ADDRESS=<<PASTE_TFE_ADDRESS_HERE>>",
        "-e", "TFE_TOKEN=<<PASTE_TFE_TOKEN_HERE>>",
        "hashicorp/terraform-mcp-server:1.3.0"
      ]
    }
  }
}

VS Code

Файл .vscode/mcp.json в проекте (версия 0.3.0 и новее):

{
  "servers": {
    "terraform": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "TFE_TOKEN=${input:tfe_token}",
        "-e", "TFE_ADDRESS=${input:tfe_address}",
        "hashicorp/terraform-mcp-server:1.3.0"
      ]
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "tfe_token",
      "description": "Terraform API Token",
      "password": true
    },
    {
      "type": "promptString",
      "id": "tfe_address",
      "description": "Terraform Address",
      "password": false
    }
  ]
}

Codex CLI

codex mcp add terraform -- docker run -i --rm hashicorp/terraform-mcp-server

Для инструментов HCP Terraform и Terraform Enterprise добавьте TFE_ADDRESS и TFE_TOKEN в команду Docker.

Gemini

Создайте или обновите ~/.gemini/.env с учётными данными (нужны только для HCP Terraform и Terraform Enterprise):

# ~/.gemini/.env
TFE_ADDRESS=your_tfe_address_here
TFE_TOKEN=your_tfe_token_here

Затем установите расширение и запустите Gemini:

gemini extensions install https://github.com/hashicorp/terraform-mcp-server
gemini

Установка из исходников

go install github.com/hashicorp/terraform-mcp-server/cmd/terraform-mcp-server@latest

Включение инструментов по группам

Группы задают флагом --toolsets (доступны registry, registry-private, terraform, all, default), отдельные инструменты флагом --tools. Использовать оба флага вместе нельзя.

# Enable tool groups
terraform-mcp-server --toolsets=registry,terraform

# Enable specific tools only
terraform-mcp-server --tools=search_provider_docs,get_provider_details,list_workspaces