Terrakube MCP Server
Servidor MCP de Terrakube
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 trabajoorganization(cadena): nombre de la organizacióndescription(cadena opcional): Descripción del espacio de trabajovcsProviderId(cadena opcional): ID del proveedor de VCSvcsRepository(cadena opcional): nombre del repositorio VCSvcsBranch(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 trabajoorganization(cadena): nombre de la organizacióndescription(cadena opcional): descripción del nuevo espacio de trabajovcsProviderId(cadena opcional): nuevo ID de proveedor de VCSvcsRepository(cadena opcional): nuevo nombre del repositorio VCSvcsBranch(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 trabajoorganization(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 trabajoorganization(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 variableorganization(cadena): nombre de la organizaciónworkspace(cadena): nombre del espacio de trabajovalue(cadena): Valor de la variabledescription(cadena opcional): Descripción de la variablecategory(cadena opcional): Categoría variablehcl(booleano opcional): si la variable es HCLsensitive(booleano opcional): si la variable es sensible
Devuelve : Detalles de la variable creada
updateVariable
Actualizar una variable existente.
Entradas :
name(cadena): Nombre de la variableorganization(cadena): nombre de la organizaciónworkspace(cadena): nombre del espacio de trabajovalue(cadena): Nuevo valor de variabledescription(cadena opcional): Nueva descripción de variablecategory(cadena opcional): Nueva categoría de variablehcl(booleano opcional): si la variable es HCLsensitive(booleano opcional): si la variable es sensible
Devuelve : Detalles de la variable actualizados
deleteVariable
Eliminar una variable.
Entradas :
name(cadena): Nombre de la variableorganization(cadena): nombre de la organizaciónworkspace(cadena): nombre del espacio de trabajo
Devoluciones : Estado de éxito
getVariable
Obtenga detalles de una variable específica.
Entradas :
name(cadena): Nombre de la variableorganization(cadena): nombre de la organizaciónworkspace(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ónworkspace(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óduloorganization(cadena): nombre de la organizaciónprovider(cadena): Proveedor del módulodescription(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óduloorganization(cadena): nombre de la organizaciónprovider(cadena): Proveedor del módulodescription(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óduloorganization(cadena): nombre de la organizaciónprovider(cadena): Proveedor del módulo
Devoluciones : Estado de éxito
getModule
Obtenga detalles de un módulo específico.
Entradas :
name(cadena): Nombre del móduloorganization(cadena): nombre de la organizaciónprovider(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óndescription(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óndescription(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 claudeDesarrollo
Clonar el repositorio:
git clone https://github.com/azbuilder/terrakube-mcp-server.git cd terrakube-mcp-serverInstalar dependencias:
npm installConstruir 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 toolscreate-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
Scored across 16 tools
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.
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.
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.
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
Related MCP Connectors
A Model Context Protocol server for Wix AI tools
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
The Telnyx MCP server is an official implementation of the Model Context Protocol that enables AI clients (like Claude Desktop, Cursor, and OpenAI Agents) to interact with Telnyx's telephony, messaging, and AI assistant APIs. It provides comprehensive capabilities including making and managing phone calls, sending SMS/MMS messages, purchasing and configuring phone numbers, creating AI assistants with custom instructions, managing cloud storage buckets, scraping and embedding website content, and handling integration secrets. The server exists as both a local implementation and a remotely hosted version, allowing developers to integrate real-world communication infrastructure directly into AI applications.
Related MCP Servers
- AlicenseAqualityDmaintenanceA Model Context Protocol (MCP) server that integrates Claude with the Terraform Cloud API, allowing Claude to manage your Terraform infrastructure through natural conversation.6223MIT
- AlicenseNot gradedqualityAmaintenanceA 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 npm625MIT
- FlicenseAqualityDmaintenanceA 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-
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables CRUD operations and querying on Microsoft Dataverse through natural language.MIT