테라쿠베 MCP 서버

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

특징

• 포괄적인 API 통합 : 원활한 운영을 위한 Terrakube API와의 완벽한 통합
• 유형 안전성 : 향상된 유형 안전성과 개발자 경험을 위해 TypeScript로 구축됨
• 오류 처리 : 명확한 오류 메시지를 통한 강력한 오류 처리
• 환경 구성 : 환경 변수를 통한 유연한 구성
• 모듈형 디자인 : 쉬운 유지관리 및 확장을 위한 체계적인 코드 구조

도구

작업 공간

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 서버를 자동으로 설치하려면:

개발

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 에 다음을 추가하세요.