Skip to main content
Glama
Terrakube MCP Server

Terrakube MCP Server

by terrakube-io

테라쿠베 MCP 서버

대장간 배지 Terrakube 작업을 위한 MCP(Model Context Protocol) 서버로, 작업 공간 관리, 변수 처리, 모듈 작업 및 조직 관리를 지원합니다.

특징

  • 포괄적인 API 통합 : 원활한 운영을 위한 Terrakube API와의 완벽한 통합

  • 유형 안전성 : 향상된 유형 안전성과 개발자 경험을 위해 TypeScript로 구축됨

  • 오류 처리 : 명확한 오류 메시지를 통한 강력한 오류 처리

  • 환경 구성 : 환경 변수를 통한 유연한 구성

  • 모듈형 디자인 : 쉬운 유지관리 및 확장을 위한 체계적인 코드 구조

Related MCP server: Coolify MCP Server

도구

작업 공간

createWorkspace

Terrakube에서 새로운 작업 공간을 만듭니다.

  • 입력 :

    • name (문자열): 작업 공간의 이름

    • organization (문자열): 조직 이름

    • description (선택적 문자열): 작업 공간 설명

    • vcsProviderId (선택 문자열): VCS 공급자 ID

    • vcsRepository (선택적 문자열): VCS 저장소 이름

    • vcsBranch (선택적 문자열): VCS 브랜치 이름

  • 반환 : 작업 공간 세부 정보 생성됨

updateWorkspace

기존 작업 공간을 업데이트합니다.

  • 입력 :

    • name (문자열): 작업 공간의 이름

    • organization (문자열): 조직 이름

    • description (선택적 문자열): 새 작업 공간 설명

    • vcsProviderId (선택 문자열): 새 VCS 공급자 ID

    • vcsRepository (선택적 문자열): 새 VCS 저장소 이름

    • vcsBranch (선택적 문자열): 새 VCS 브랜치 이름

  • 반환 : 업데이트된 작업 공간 세부 정보

deleteWorkspace

작업 공간을 삭제합니다.

  • 입력 :

    • name (문자열): 작업 공간의 이름

    • organization (문자열): 조직 이름

  • 반환 : 성공 상태

getWorkspace

특정 작업 공간에 대한 세부 정보를 얻으세요.

  • 입력 :

    • name (문자열): 작업 공간의 이름

    • organization (문자열): 조직 이름

  • 반환 : 작업 공간 세부 정보

listWorkspaces

조직의 모든 작업 공간을 나열합니다.

  • 입력 :

    • organization (문자열): 조직 이름

  • 반환 : 작업 공간 세부 정보 배열

변수

createVariable

작업 공간에 새로운 변수를 만듭니다.

  • 입력 :

    • name (문자열): 변수의 이름

    • organization (문자열): 조직 이름

    • workspace (문자열): 작업 공간 이름

    • value (문자열): 변수 값

    • description (선택적 문자열): 변수 설명

    • category (선택적 문자열): 변수 category

    • hcl (선택적 부울): 변수가 HCL인지 여부

    • sensitive (선택적 부울): 변수가 민감한지 여부

  • 반환 : 생성된 변수 세부 정보

updateVariable

기존 변수를 업데이트합니다.

  • 입력 :

    • name (문자열): 변수의 이름

    • organization (문자열): 조직 이름

    • workspace (문자열): 작업 공간 이름

    • value (문자열): 새 변수 값

    • description (선택적 문자열): 새 변수 설명

    • category (선택적 문자열): 새 변수 category

    • hcl (선택적 부울): 변수가 HCL인지 여부

    • sensitive (선택적 부울): 변수가 민감한지 여부

  • 반환 : 업데이트된 변수 세부 정보

deleteVariable

변수를 삭제합니다.

  • 입력 :

    • name (문자열): 변수의 이름

    • organization (문자열): 조직 이름

    • workspace (문자열): 작업 공간 이름

  • 반환 : 성공 상태

getVariable

특정 변수에 대한 세부 정보를 얻으세요.

  • 입력 :

    • name (문자열): 변수의 이름

    • organization (문자열): 조직 이름

    • workspace (문자열): 작업 공간 이름

  • 반환 : 변수 세부 정보

listVariables

작업 공간에 있는 모든 변수를 나열합니다.

  • 입력 :

    • organization (문자열): 조직 이름

    • workspace (문자열): 작업 공간 이름

  • 반환 : 변수 세부 정보 배열

모듈

createModule

새로운 모듈을 만듭니다.

  • 입력 :

    • name (문자열): 모듈의 이름

    • organization (문자열): 조직 이름

    • provider (문자열): 모듈 공급자

    • description (선택적 문자열): 모듈 설명

  • 반환 : 생성된 모듈 세부 정보

updateModule

기존 모듈을 업데이트합니다.

  • 입력 :

    • name (문자열): 모듈의 이름

    • organization (문자열): 조직 이름

    • provider (문자열): 모듈 공급자

    • description (선택적 문자열): 새 모듈 설명

  • 반환 : 업데이트된 모듈 세부 정보

deleteModule

모듈을 삭제합니다.

  • 입력 :

    • name (문자열): 모듈의 이름

    • organization (문자열): 조직 이름

    • provider (문자열): 모듈 공급자

  • 반환 : 성공 상태

getModule

특정 모듈에 대한 세부 정보를 얻으세요.

  • 입력 :

    • name (문자열): 모듈의 이름

    • organization (문자열): 조직 이름

    • provider (문자열): 모듈 공급자

  • 반환 : 모듈 세부 정보

listModules

조직의 모든 모듈을 나열합니다.

  • 입력 :

    • organization (문자열): 조직 이름

  • 반환 : 모듈 세부 정보 배열

조직

createOrganization

새로운 조직을 만드세요.

  • 입력 :

    • name (문자열): 조직의 이름

    • description (선택 문자열): 조직 설명

  • 반환 : 조직 세부 정보가 생성되었습니다.

updateOrganization

기존 조직을 업데이트합니다.

  • 입력 :

    • name (문자열): 조직의 이름

    • description (선택 문자열): 새로운 조직 설명

  • 반품 : 조직 세부 정보 업데이트됨

deleteOrganization

조직을 삭제합니다.

  • 입력 :

    • name (문자열): 조직의 이름

  • 반환 : 성공 상태

getOrganization

특정 조직에 대한 세부 정보를 얻으세요.

  • 입력 :

    • name (문자열): 조직의 이름

  • 반품 : 조직 세부 정보

listOrganizations

모든 조직을 나열하세요.

  • 반환 : 조직 세부 정보 배열

설정

환경 변수

다음 변수를 사용하여 루트 디렉토리에 .env 파일을 만듭니다.

지엑스피1

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 Terrakube MCP 서버를 자동으로 설치하려면:

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

개발

  1. 저장소를 복제합니다.

    git clone https://github.com/azbuilder/terrakube-mcp-server.git
    cd terrakube-mcp-server
  2. 종속성 설치:

    npm install
  3. 프로젝트를 빌드하세요:

    npm run build

Claude Desktop과 함께 사용

Claude Desktop과 함께 사용하려면 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