Kubectl MCP Server : 자연어로 Kubernetes클러스터를 제어하기

안녕하세요.

오늘은 AI와 Kubernetes 클러스터를 연결해주는 놀라운 도구, kubectl-mcp-server에 대해 소개드립니다. 이 도구는 Claude, Cursor, Windsurf와 같은 AI 어시스턴트가 자연어로 Kubernetes를 제어할 수 있도록 도와주는 MCP 서버입니다. 복잡한 명령어 없이 클러스터를 관리하고 싶다면 이 글을 끝까지 읽어보세요!

 

---

Kubectl MCP Tool이란?

Kubectl MCP Tool은 kubectl을 AI와 연결시켜주는 확장 도구입니다. 이 도구는 자연어(NLP) 기반으로 Kubernetes 명령어를 처리하고, 보안, 모니터링, 진단 기능까지 포함한 통합 플랫폼입니다.

🧠 기존 kubectl과의 차이점

• 자연어 명령어 해석 → AI와 대화하듯 Kubernetes 제어
• kubectl explain 기반의 지능형 설명 기능
• 보안 및 상태 진단 내장

💬 자연어 제어 예시

• “현재 실행 중인 Pod 목록 보여줘” → kubectl get pods
• “이전 버전으로 롤백해줘” → kubectl rollout undo deployment my-app

---

주요 기능 소개

1️⃣ Kubernetes 리소스 관리

• Pod, Deployment, Service, Node 생성 및 삭제
• kubectl describe, delete, logs 등 기본 명령 지원
• Helm v3 지원 (배포, 업그레이드, 삭제)

2️⃣ 자연어 처리 기반 제어

• 문맥 기억(Contextual memory) 기능
• AI 기반 지능형 명령어 구성
• 명령어가 없을 경우 kubectl로 대체 실행

3️⃣ 클러스터 모니터링 및 진단

• kubectl top 기반 자원 사용량 조회
• Pod 상태, 이벤트, 헬스 체크 확인
• 구성 오류 및 패턴 분석

4️⃣ 보안 관리

• RBAC 권한 검토 및 역할 분석
• PodSecurityPolicy, NetworkPolicy 분석
• ServiceAccount 바인딩, 컨테이너 보안 점검

---

반응형

설치 방법

1. 필수 준비 사항

• ☑️ Python 3.9+
• ☑️ kubectl 설치 및 구성
• ☑️ Kubernetes 클러스터 접근 권한

2. PyPI 설치 명령어

pip install kubectl-mcp-tool

3. 개발 버전 설치(GitHub)

pip install git+https://github.com/rohitg00/kubectl-mcp-server.git

4. 설치 확인

kubectl-mcp --help

---

사용 방법

🏗 CLI 모드에서 사용하기

• kubectl-mcp get pods → Pod 목록 조회
• kubectl-mcp get services → 서비스 목록 조회
• kubectl-mcp rollout undo deployment my-app → 롤백

🤖 AI 어시스턴트와 연계하기

Claude, Cursor, WindSurf와 연동하여 자연어로 명령어를 실행할 수 있습니다.

📌 Claude 설정 예시

{
  "mcpServers": {
    "kubernetes": {
      "command": "python",
      "args": ["-m", "kubectl_mcp_tool.minimal_wrapper"],
      "env": {
        "KUBECONFIG": "/home/사용자/.kube/config"
      }
    }
  }
}

📌 Cursor 설정 예시

{
  "mcpServers": {
    "kubernetes": {
      "command": "python",
      "args": ["-m", "kubectl_mcp_tool.minimal_wrapper"],
      "env": {
        "KUBECONFIG": "/Users/사용자/.kube/config"
      }
    }
  }
}

---

결론

• Kubectl MCP Tool은 기존 kubectl보다 직관적입니다.
• AI와 자연어로 Kubernetes를 관리할 수 있습니다.
• 보안, 모니터링, 리소스 제어까지 통합 지원합니다.

이제 복잡한 명령어 없이 AI와 대화하듯 클러스터를 관리해 보세요!

 

---

출처

https://github.com/rohitg00/kubectl-mcp-server

GitHub - rohitg00/kubectl-mcp-server: A Model Context Protocol (MCP) server for Kubernetes that enables AI assistants like Claud