이제 쿠버네티스를 자연어로 관리한다? Claude와 함께하는 MCP-Server-Kubernetes 완벽 가이드
쿠버네티스 관리가 어려우셨나요? 복잡한 kubectl 명령어, 끝없는 CLI 복붙, 오류 추적의 고통. 이런 고민을 AI가 대신 해결해준다면 어떨까요?
이제는 가능합니다. Claude AI와 MCP-Server-Kubernetes의 만남이 바로 그 해답입니다.
이 블로그에서는 MCP-Server-Kubernetes의 개념부터 실제 사용 방법까지 차근차근 정리해드립니다. 쿠버네티스를 쉽게, 더 스마트하게 다뤄보세요.
MCP-Server-Kubernetes란 무엇인가?
MCP-Server-Kubernetes는 Claude AI가 자연어로 쿠버네티스 클러스터와 상호작용할 수 있도록 돕는 오픈소스 프로젝트입니다.
MCP(Model Context Protocol)를 기반으로, Claude가 시스템 명령어 대신 대화를 통해 클러스터를 조작할 수 있게 해주는 중간 다리 역할을 합니다.
즉, 복잡한 명령어 없이도 다음과 같은 작업이 가능해집니다:
- 파드, 서비스, 디플로이먼트 조회 및 설명
- 새로운 리소스 생성
- 로그 조회
- Helm 차트 관리
- 디플로이먼트 스케일링
주요 기능 정리
🔍 리소스 관리
- 조회 및 설명: Pod, Service, Deployment, Node, Namespace, CronJob 등
- 생성 및 삭제: 다양한 리소스의 손쉬운 생성 및 제거
- 설정 변경: ConfigMap 생성, 수정 및 관리
🚀 디플로이먼트 운영
- 스케일링: 레플리카 수 조절
- 업데이트: 이미지 및 설정 업데이트
- 로그 확인: 디버깅용 로그 수집 가능
📦 Helm 통합
- 차트 설치: 사용자 설정값으로 Helm 차트 배포
- 릴리즈 관리: 업데이트, 제거, 릴리즈 확인
- 커스텀 레포지토리 지원
🌐 네트워크 설정
- 포트 포워딩: 로컬 머신으로 포트 연결
- 서비스 관리: 서비스 생성, 설명, 업데이트
🔍 클러스터 탐색 기능
- 리소스 설명: kubectl explain 수준의 정보 제공
- 이벤트 확인: 클러스터 이벤트 추적
- API 리소스 목록화
🛡️ 안전성 강화 기능
- 비파괴 모드(read-only) 지원: 실수 방지, 안전한 운영 가능
Claude와 함께하는 MCP-Server-Kubernetes 사용 가이드 (Step-by-Step)
✅ 사전 준비사항
- 쿠버네티스 클러스터 접근 권한
- kubectl 설치 및 설정 완료
- Node.js (v18 이상) 설치
- Claude Desktop 앱 설치
1️⃣ 쿠버네티스 환경 확인
kubectl get nodes
노드 리스트가 정상 출력되면 준비 완료입니다.
2️⃣ MCP-Server-Kubernetes 설치
npm install -g mcp-server-kubernetes
또는 별도 설치 없이 실행도 가능:
npx mcp-server-kubernetes
3️⃣ Claude Desktop 설정 파일 수정
위치 예시:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
설정 예시:
{
"mcpServers": {
"kubernetes": {
"command": "npx",
"args": ["mcp-server-kubernetes"]
}
}
}
안전모드(읽기 전용)는 "ALLOW_ONLY_NON_DESTRUCTIVE_TOOLS": "true"를 추가.
4️⃣ Claude Desktop 실행
앱을 실행하면 MCP 서버 연결을 자동으로 불러옵니다.
5️⃣ 연결 확인
Claude에게 이렇게 물어보세요:
Can you check if you're connected to my Kubernetes cluster and list the namespaces?
정상 연결되면 네임스페이스 목록을 반환합니다.
6️⃣ 기본 쿠버네티스 명령어
예시:
Please list all pods in the default namespace.
Claude가 기본 네임스페이스 내 파드 목록을 보여줍니다.
7️⃣ 리소스 생성
Please create a deployment named "hello-world" with the nginx image and 2 replicas in the default namespace.
→ 디플로이먼트가 바로 생성됩니다!
8️⃣ 로그 확인
Can you show me the logs from the hello-world deployment?
→ 파드에서 출력된 로그 내용을 Claude가 직접 반환합니다.
9️⃣ 디플로이먼트 스케일링
Please scale the hello-world deployment to 3 replicas.
→ 레플리카 수를 실시간으로 조절 가능합니다.
🔟 리소스 정리
Please delete the hello-world deployment.
→ 생성한 리소스를 Claude가 깔끔하게 삭제해줍니다.
고급 기능: Helm 차트도 Claude가 대신 설치한다
예시 명령어:
Can you install the bitnami/nginx Helm chart with release name "my-nginx" in the default namespace?
Claude가 Helm 설치까지 자연어로 처리해줍니다.
Claude + MCP = 쿠버네티스 관리의 미래
MCP-Server-Kubernetes는 단순한 AI 연결 도구가 아닙니다.
쿠버네티스를 누구나 쉽게 다룰 수 있는 인터페이스로 바꿔주는 혁신적인 솔루션입니다.
- DevOps 경험자는 워크플로우를 대폭 간소화할 수 있고,
- 입문자는 어려운 명령어 없이 클러스터를 탐색할 수 있습니다.
복잡한 운영을 더는 혼자 끌어안지 마세요.
AI와 함께, 자연어로 쿠버네티스를 말로 관리하는 시대가 열렸습니다.
지금 바로 Claude와 함께 MCP-Server-Kubernetes를 경험해보세요!
Kubernetes MCP Server: Step by Step Guide
In today's cloud-native world, managing Kubernetes clusters efficiently is crucial for DevOps professionals and platform engineers. While command-line tools like kubectl are powerful, wouldn't it be
collabnix.com
