mcp-server-kubernetes

MCP 서버 쿠버네티스

Kubernetes 클러스터에 연결하여 관리할 수 있는 MCP 서버입니다.

https://github.com/user-attachments/assets/f25f8f4e-4d04-479b-9ae0-5dac452dd2ed

Claude Desktop과 함께 사용

지엑스피1

서버가 현재 kubectl 컨텍스트에 자동으로 연결됩니다. 다음 사항을 확인하세요.

1. kubectl이 설치되었고 PATH에 있습니다.
2. 컨텍스트가 구성된 유효한 kubeconfig 파일
3. kubectl에 대해 구성된 Kubernetes 클러스터에 대한 액세스(예: minikube, Rancher Desktop, GKE 등)
4. Helm v3가 설치되어 PATH에 등록되어 있어야 합니다(Tiller는 필요 없습니다). Helm을 사용하지 않을 경우 선택 사항입니다.

Claude에게 포드를 나열하거나 테스트 배포를 생성하도록 요청하여 연결을 확인할 수 있습니다.

오류가 발생하면 표준 터미널을 열고 kubectl get pods 실행하여 자격 증명 문제 없이 클러스터에 연결할 수 있는지 확인하세요.

mcp-chat과 함께 사용

mcp-chat 은 MCP 서버용 CLI 채팅 클라이언트입니다. 쿠버네티스 서버와 상호 작용하는 데 사용할 수 있습니다.

또는 위에서 언급한 기존 Claude Desktop 구성 파일을 전달하세요(Linux는 config에 대한 올바른 경로를 전달해야 함).

스코틀랜드 사람:

윈도우:

특징

• [x] Kubernetes 클러스터에 연결
• [x] 모든 포드, 서비스, 배포를 나열합니다.
• [x] 목록, 노드 설명
• [x] 포드 생성, 설명, 삭제
• [x] 모든 네임스페이스 나열, 네임스페이스 생성
• [x] 사용자 정의 포드 및 배포 구성 생성, 배포 복제본 업데이트
• [x] 서비스 생성, 설명, 삭제, 업데이트
• [x] ConfigMap 생성, 가져오기, 업데이트, 삭제
• [x] 디버깅을 위해 포드에서 로그 가져오기(포드, 배포, 작업 및 레이블 선택기 지원)
• [x] 차트 설치를 위한 Helm v3 지원
  • 사용자 정의 값으로 차트 설치
  • 릴리스 제거
  • 기존 릴리스 업그레이드
  • 네임스페이스 지원
  • 버전 사양 지원
  • 사용자 정의 저장소 지원
• [x] kubectl explain 및 kubectl api-resources support
• [x] 클러스터에서 Kubernetes 이벤트 가져오기
• [x] 포드 또는 서비스로 포트 포워딩
• [x] Cronjob을 생성, 나열 및 설명합니다.
• [x] 클러스터에 대한 읽기 및 생성/업데이트 전용 액세스를 위한 비파괴 모드

지역 개발

bun이 설치되어 있는지 확인하세요. 저장소를 복제하고 종속성을 설치하세요.

개발 워크플로

1. 개발 모드로 서버를 시작합니다(파일 변경 사항을 감시합니다):

2. 단위 테스트 실행:

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

4. 검사관 과 함께하는 로컬 테스트

5. Claude Desktop을 사용한 로컬 테스트

6. mcp-chat을 사용한 로컬 테스트

기여하다

자세한 내용은 CONTRIBUTING.md 파일을 참조하세요.

고급의

추가 고급 기능

SSE 전송 사용, ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS 사용한 비파괴 모드와 같은 고급 정보는 ADVANCED_README.md 를 참조하세요.

건축학

Devin이 만든 보다 자세한 아키텍처 개요를 보려면 이 DeepWiki 링크를 참조하세요.

이 섹션에서는 MCP Kubernetes 서버의 고수준 아키텍처를 설명합니다.

요청 흐름

아래의 시퀀스 다이어그램은 요청이 시스템을 통해 흐르는 방식을 보여줍니다.

새로운 릴리스를 게시합니다

릴리스 페이지 로 이동하여 "새 릴리스 초안 작성"을 클릭하고 "태그 선택"을 클릭한 후, "v{major}.{minor}.{patch}" semver 형식으로 새 버전 번호를 입력하여 새 태그를 만드세요. 그런 다음 릴리스 제목을 "Release v{major}.{minor}.{patch}"로 입력하고, 필요한 경우 설명/변경 로그를 입력한 후 "릴리스 게시"를 클릭하세요.

이렇게 하면 cd.yml 워크플로를 통해 새 릴리스 빌드를 트리거하는 새 태그가 생성됩니다. 성공하면 새 릴리스가 npm 에 게시됩니다. package.json 버전을 수동으로 업데이트할 필요는 없습니다. 워크플로가 package.json 파일의 버전 번호를 자동으로 업데이트하고 main에 커밋을 푸시하기 때문입니다.

계획되지 않음

인증/kubectx에 클러스터 추가.