큐브 코어 MCP
자연어 요청을 유효한 kubectl 명령으로 변환하는 Kubernetes 명령 처리 서비스입니다.
특징
- 자연어를 kubectl 명령어로 변환
- 명령 검증 및 보안 검사
- 일반적인 kubectl 작업 지원
- LLM 처리를 위한 AWS Bedrock 통합
필수 조건
- 파이썬 3.8 이상
- AWS 자격 증명이 구성됨
- kubectl 설치 및 구성
- Node.js와 npm(프론트엔드용)
설정
- 저장소를 복제합니다.
지엑스피1
- 가상 환경을 만들고 활성화하세요.
python3 -m venv venv
source venv/bin/activate # On Windows: .\venv\Scripts\activate
- 종속성 설치:
pip install -r requirements.txt
- AWS 자격 증명을 구성합니다.
export AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key
export AWS_REGION=your_region
- FastAPI 서버를 시작합니다.
API 문서
건강 검진
curl http://localhost:3000/health
서비스
curl http://localhost:3000/api/services
자연어 명령
curl -X POST http://localhost:3000/api/nl \
-H "Content-Type: application/json" \
-d '{"message": "show me the pods in default namespace"}'
직접 명령
curl -X POST http://localhost:3000/api/command \
-H "Content-Type: application/json" \
-d '{"command": "kubectl get pods -n default"}'
보안
이 서비스는 두 가지 보안 모드로 운영됩니다.
- 엄격함(기본값):
- 미리 정의된 명령 패턴만 허용합니다.
- 허용된 패턴에 대해 모든 명령을 검증합니다.
- 위험한 작업을 방지합니다
- 허용:
- 더욱 유연한 명령 패턴을 허용합니다.
- 여전히 기본 보안 검사를 유지합니다.
- 개발 및 테스트에 유용합니다
개발
테스트 실행
코드 스타일
black src/ tests/
flake8 src/ tests/
기여하다
- 저장소를 포크하세요
- 기능 브랜치 생성
- 변경 사항을 만드세요
- 테스트 실행
- 풀 리퀘스트 제출
특허
[라이센스 정보 추가]