Skip to main content
Glama
Terrakube MCP Server

Terrakube MCP Server

by terrakube-io

Servidor MCP de Terrakube

insignia de herrería Un servidor de Protocolo de Contexto de Modelo (MCP) para operaciones de Terrakube, que permite la gestión del espacio de trabajo, el manejo de variables, las operaciones de módulos y la gestión de la organización.

Características

  • Integración completa de API : integración completa con la API de Terrakube para operaciones fluidas

  • Seguridad de tipos : creado con TypeScript para mejorar la seguridad de tipos y la experiencia del desarrollador.

  • Manejo de errores : Manejo de errores robusto con mensajes de error claros

  • Configuración del entorno : Configuración flexible mediante variables de entorno

  • Diseño modular : Estructura de código organizada para un fácil mantenimiento y ampliación.

Related MCP server: Coolify MCP Server

Herramientas

Espacios de trabajo

createWorkspace

Crea un nuevo espacio de trabajo en Terrakube.

  • Entradas :

    • name (cadena): Nombre del espacio de trabajo

    • organization (cadena): nombre de la organización

    • description (cadena opcional): Descripción del espacio de trabajo

    • vcsProviderId (cadena opcional): ID del proveedor de VCS

    • vcsRepository (cadena opcional): nombre del repositorio VCS

    • vcsBranch (cadena opcional): nombre de la rama VCS

  • Devuelve : Detalles del espacio de trabajo creado

updateWorkspace

Actualizar un espacio de trabajo existente.

  • Entradas :

    • name (cadena): Nombre del espacio de trabajo

    • organization (cadena): nombre de la organización

    • description (cadena opcional): descripción del nuevo espacio de trabajo

    • vcsProviderId (cadena opcional): nuevo ID de proveedor de VCS

    • vcsRepository (cadena opcional): nuevo nombre del repositorio VCS

    • vcsBranch (cadena opcional): nuevo nombre de rama de VCS

  • Devoluciones : Detalles del espacio de trabajo actualizados

deleteWorkspace

Eliminar un espacio de trabajo.

  • Entradas :

    • name (cadena): Nombre del espacio de trabajo

    • organization (cadena): nombre de la organización

  • Devoluciones : Estado de éxito

getWorkspace

Obtenga detalles de un espacio de trabajo específico.

  • Entradas :

    • name (cadena): Nombre del espacio de trabajo

    • organization (cadena): nombre de la organización

  • Devoluciones : Detalles del espacio de trabajo

listWorkspaces

Enumere todos los espacios de trabajo de una organización.

  • Entradas :

    • organization (cadena): nombre de la organización

  • Devuelve : Matriz de detalles del espacio de trabajo

Variables

createVariable

Crear una nueva variable en un espacio de trabajo.

  • Entradas :

    • name (cadena): Nombre de la variable

    • organization (cadena): nombre de la organización

    • workspace (cadena): nombre del espacio de trabajo

    • value (cadena): Valor de la variable

    • description (cadena opcional): Descripción de la variable

    • category (cadena opcional): Categoría variable

    • hcl (booleano opcional): si la variable es HCL

    • sensitive (booleano opcional): si la variable es sensible

  • Devuelve : Detalles de la variable creada

updateVariable

Actualizar una variable existente.

  • Entradas :

    • name (cadena): Nombre de la variable

    • organization (cadena): nombre de la organización

    • workspace (cadena): nombre del espacio de trabajo

    • value (cadena): Nuevo valor de variable

    • description (cadena opcional): Nueva descripción de variable

    • category (cadena opcional): Nueva categoría de variable

    • hcl (booleano opcional): si la variable es HCL

    • sensitive (booleano opcional): si la variable es sensible

  • Devuelve : Detalles de la variable actualizados

deleteVariable

Eliminar una variable.

  • Entradas :

    • name (cadena): Nombre de la variable

    • organization (cadena): nombre de la organización

    • workspace (cadena): nombre del espacio de trabajo

  • Devoluciones : Estado de éxito

getVariable

Obtenga detalles de una variable específica.

  • Entradas :

    • name (cadena): Nombre de la variable

    • organization (cadena): nombre de la organización

    • workspace (cadena): nombre del espacio de trabajo

  • Devoluciones : Detalles de la variable

listVariables

Enumere todas las variables en un espacio de trabajo.

  • Entradas :

    • organization (cadena): nombre de la organización

    • workspace (cadena): nombre del espacio de trabajo

  • Devuelve : Matriz de detalles de variables

Módulos

createModule

Crear un nuevo módulo.

  • Entradas :

    • name (cadena): Nombre del módulo

    • organization (cadena): nombre de la organización

    • provider (cadena): Proveedor del módulo

    • description (cadena opcional): Descripción del módulo

  • Devuelve : Detalles del módulo creado

updateModule

Actualizar un módulo existente.

  • Entradas :

    • name (cadena): Nombre del módulo

    • organization (cadena): nombre de la organización

    • provider (cadena): Proveedor del módulo

    • description (cadena opcional): Descripción del nuevo módulo

  • Devoluciones : Detalles del módulo actualizados

deleteModule

Eliminar un módulo.

  • Entradas :

    • name (cadena): Nombre del módulo

    • organization (cadena): nombre de la organización

    • provider (cadena): Proveedor del módulo

  • Devoluciones : Estado de éxito

getModule

Obtenga detalles de un módulo específico.

  • Entradas :

    • name (cadena): Nombre del módulo

    • organization (cadena): nombre de la organización

    • provider (cadena): Proveedor del módulo

  • Devoluciones : Detalles del módulo

listModules

Enumere todos los módulos de una organización.

  • Entradas :

    • organization (cadena): nombre de la organización

  • Devuelve : Matriz de detalles del módulo

Organizaciones

createOrganization

Crear una nueva organización.

  • Entradas :

    • name (cadena): Nombre de la organización

    • description (cadena opcional): Descripción de la organización

  • Devoluciones : Detalles de la organización creada

updateOrganization

Actualizar una organización existente.

  • Entradas :

    • name (cadena): Nombre de la organización

    • description (cadena opcional): Nueva descripción de la organización

  • Devoluciones : Detalles de la organización actualizados

deleteOrganization

Eliminar una organización.

  • Entradas :

    • name (cadena): Nombre de la organización

  • Devoluciones : Estado de éxito

getOrganization

Obtenga detalles de una organización específica.

  • Entradas :

    • name (cadena): Nombre de la organización

  • Devoluciones : Detalles de la organización

listOrganizations

Enumere todas las organizaciones.

  • Devuelve : Matriz de detalles de la organización

Configuración

Variables de entorno

Cree un archivo .env en el directorio raíz con las siguientes variables:

TERRAKUBE_API_URL=<your-terrakube-api-url>
TERRAKUBE_PAT_TOKEN=<your-personal-access-token>

Instalación mediante herrería

Para instalar Terrakube MCP Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @AzBuilder/mcp-server-terrakube --client claude

Desarrollo

  1. Clonar el repositorio:

    git clone https://github.com/azbuilder/terrakube-mcp-server.git
    cd terrakube-mcp-server
  2. Instalar dependencias:

    npm install
  3. Construir el proyecto:

    npm run build

Uso con Claude Desktop

Para usar esto con Claude Desktop, agregue lo siguiente a su claude_desktop_config.json :

{
  "mcpServers": {
    "terrakube": {
      "command": "npx",
      "args": [
        "-y",
        "@terrakube/mcp-server"
      ],
      "env": {
        "TERRAKUBE_API_URL": "<YOUR_API_URL>",
        "TERRAKUBE_PAT_TOKEN": "<YOUR_PAT_TOKEN>"
      }
    }
  }
}

Available Tools

16 tools
create-moduleC

Creates a new module in the specified organization

Inputs: name (required), organizationId (required), provider (required), registry (required), +1 more.

create-organizationC

Creates a new organization with the specified name and optional description

Inputs: name (required), description.

create-variableC

Creates a new variable in the specified workspace

Inputs: key (required), organizationId (required), value (required), workspaceId (required), +3 more.

create-workspaceC

Creates a new workspace in the specified organization

Inputs: name (required), organizationId (required), terraformVersion (required), description, +2 more.

edit-moduleC

Updates an existing module's details

Inputs: moduleId (required), organizationId (required), description, name, +2 more.

edit-organizationC

Updates an existing organization's details

Inputs: id (required), description, name.

edit-variableC

Updates an existing variable's details

Inputs: organizationId (required), variableId (required), workspaceId (required), category, +4 more.

edit-workspaceC

Updates an existing workspace's details

Inputs: organizationId (required), workspaceId (required), description, name, +3 more.

get-moduleC

Retrieves detailed information about a specific module

Inputs: moduleId (required), organizationId (required).

get-organizationB

Retrieves detailed information about a specific organization by its ID

Inputs: id (required).

get-variableC

Retrieves detailed information about a specific variable

Inputs: organizationId (required), variableId (required), workspaceId (required).

get-workspaceC

Retrieves detailed information about a specific workspace

Inputs: organizationId (required), workspaceId (required).

list-modulesB

Lists all modules in the specified organization

Inputs: organizationId (required).

list-organizationsB

Lists all organizations accessible to the current user

Inputs: no named parameters.

list-variablesB

Lists all variables in the specified workspace

Inputs: organizationId (required), workspaceId (required).

list-workspacesC

Lists all workspaces in the specified organization

Inputs: organizationId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 16 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose with no ambiguity, as each combines a specific action (create, edit, get, list) with a specific resource type (module, organization, variable, workspace). The descriptions reinforce this clarity, making misselection unlikely.

    Naming Consistency5/5

    Tool names follow a perfectly consistent verb-noun pattern throughout, using hyphen-separated lowercase (e.g., create-module, edit-organization). All tools adhere to this convention without any deviations or mixed styles.

    Tool Count5/5

    With 16 tools, the count is well-scoped for managing Terraform-like resources (modules, organizations, variables, workspaces). Each tool earns its place by covering CRUD operations across four resource types, avoiding bloat or thinness.

    Completeness5/5

    The tool set provides complete CRUD/lifecycle coverage for the inferred domain of infrastructure management, with create, edit, get, and list operations for all four resource types. There are no obvious gaps or dead ends in the surface.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that integrates Claude with the Terraform Cloud API, allowing Claude to manage your Terraform infrastructure through natural conversation.
      62
      23
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      A Model Context Protocol server that enables AI assistants to interact with Coolify instances through natural language, allowing management of servers, applications, databases, and deployments.
      6,409 npm
      625
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      A containerized Model Context Protocol server that enables using natural language to develop AWS infrastructure with Terraform, offering best practices guidance, security scanning with Checkov, and access to AWS provider documentation.
      7
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables CRUD operations and querying on Microsoft Dataverse through natural language.
      MIT