테라쿠베 MCP 서버

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

특징

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

Related MCP server: Kubectl MCP Tool

도구

작업 공간

`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

개발

저장소를 복제합니다.
git clone https://github.com/azbuilder/terrakube-mcp-server.git cd terrakube-mcp-server
종속성 설치:
npm install
프로젝트를 빌드하세요:
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>" } } } }

Terrakube MCP Server