Terrakube MCP Server

A Model Context Protocol (MCP) server for Terrakube operations, enabling workspace management, variable handling, module operations, and organization management.

Features

• Comprehensive API Integration: Full integration with Terrakube's API for seamless operations

• Type Safety: Built with TypeScript for enhanced type safety and developer experience

• Error Handling: Robust error handling with clear error messages

• Environment Configuration: Flexible configuration through environment variables

• Modular Design: Organized code structure for easy maintenance and extension

Related MCP server: Coolify MCP Server

Tools

Workspaces

createWorkspace

Create a new workspace in Terrakube.

• Inputs:

  • name (string): Name of the workspace

  • organization (string): Organization name

  • description (optional string): Workspace description

  • vcsProviderId (optional string): VCS provider ID

  • vcsRepository (optional string): VCS repository name

  • vcsBranch (optional string): VCS branch name

• Returns: Created workspace details

updateWorkspace

Update an existing workspace.

• Inputs:

  • name (string): Name of the workspace

  • organization (string): Organization name

  • description (optional string): New workspace description

  • vcsProviderId (optional string): New VCS provider ID

  • vcsRepository (optional string): New VCS repository name

  • vcsBranch (optional string): New VCS branch name

• Returns: Updated workspace details

deleteWorkspace

Delete a workspace.

• Inputs:

  • name (string): Name of the workspace

  • organization (string): Organization name

• Returns: Success status

getWorkspace

Get details of a specific workspace.

• Inputs:

  • name (string): Name of the workspace

  • organization (string): Organization name

• Returns: Workspace details

listWorkspaces

List all workspaces in an organization.

• Inputs:

  • organization (string): Organization name

• Returns: Array of workspace details

Variables

createVariable

Create a new variable in a workspace.

• Inputs:

  • name (string): Name of the variable

  • organization (string): Organization name

  • workspace (string): Workspace name

  • value (string): Variable value

  • description (optional string): Variable description

  • category (optional string): Variable category

  • hcl (optional boolean): Whether the variable is HCL

  • sensitive (optional boolean): Whether the variable is sensitive

• Returns: Created variable details

updateVariable

Update an existing variable.

• Inputs:

  • name (string): Name of the variable

  • organization (string): Organization name

  • workspace (string): Workspace name

  • value (string): New variable value

  • description (optional string): New variable description

  • category (optional string): New variable category

  • hcl (optional boolean): Whether the variable is HCL

  • sensitive (optional boolean): Whether the variable is sensitive

• Returns: Updated variable details

deleteVariable

Delete a variable.

• Inputs:

  • name (string): Name of the variable

  • organization (string): Organization name

  • workspace (string): Workspace name

• Returns: Success status

getVariable

Get details of a specific variable.

• Inputs:

  • name (string): Name of the variable

  • organization (string): Organization name

  • workspace (string): Workspace name

• Returns: Variable details

listVariables

List all variables in a workspace.

• Inputs:

  • organization (string): Organization name

  • workspace (string): Workspace name

• Returns: Array of variable details

Modules

createModule

Create a new module.

• Inputs:

  • name (string): Name of the module

  • organization (string): Organization name

  • provider (string): Module provider

  • description (optional string): Module description

• Returns: Created module details

updateModule

Update an existing module.

• Inputs:

  • name (string): Name of the module

  • organization (string): Organization name

  • provider (string): Module provider

  • description (optional string): New module description

• Returns: Updated module details

deleteModule

Delete a module.

• Inputs:

  • name (string): Name of the module

  • organization (string): Organization name

  • provider (string): Module provider

• Returns: Success status

getModule

Get details of a specific module.

• Inputs:

  • name (string): Name of the module

  • organization (string): Organization name

  • provider (string): Module provider

• Returns: Module details

listModules

List all modules in an organization.

• Inputs:

  • organization (string): Organization name

• Returns: Array of module details

Organizations

createOrganization

Create a new organization.

• Inputs:

  • name (string): Name of the organization

  • description (optional string): Organization description

• Returns: Created organization details

updateOrganization

Update an existing organization.

• Inputs:

  • name (string): Name of the organization

  • description (optional string): New organization description

• Returns: Updated organization details

deleteOrganization

Delete an organization.

• Inputs:

  • name (string): Name of the organization

• Returns: Success status

getOrganization

Get details of a specific organization.

• Inputs:

  • name (string): Name of the organization

• Returns: Organization details

listOrganizations

List all organizations.

• Returns: Array of organization details

Setup

Environment Variables

Create a .env file in the root directory with the following variables:

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

Installing via Smithery

To install Terrakube MCP Server for Claude Desktop automatically via Smithery:

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

Development

1. Clone the repository:

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

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

Usage with Claude Desktop

To use this with Claude Desktop, add the following to your 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>"
      }
    }
  }
}