Kubernetes 클러스터에 연결하고 관리할 수 있는 MCP 서버입니다. 여러 소스에서 우선순위로 kubeconfig를 불러올 수 있습니다.

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

설치 및 사용

전제 조건

이 MCP 서버를 어떤 도구와 함께 사용하기 전에, 다음을 반드시 확인하세요:

1. kubectl 설치 및 PATH에 포함
2. 컨텍스트가 설정된 유효한 kubeconfig 파일
3. kubectl용으로 구성된 쿠버네티스 클러스터(예: minikube, Rancher Desktop, GKE 등) 접근
4. Helm v3가 설치되어 PATH에 삽입됨 (Tiller 필요 없음). Helm 사용 계획이 없다면 선택 사항입니다.

터미널에서 kubectl get pods을 실행하면 자격 증명 문제 없이 클러스터에 연결할 수 있는지 확인할 수 있습니다.

기본적으로 서버는 ~/.kube/config에서 kubeconfig를 불러옵니다. 추가 인증 옵션(환경 변수, 커스텀 경로 등)에 대해서는 ADVANCED_README.md를 참조하세요.

클로드 코드

내장된 명령어를 사용하여 MCP 서버를 Claude Code에 추가하세요:

이렇게 하면 Claude Code MCP 설정에서 자동으로 서버를 구성합니다.

코덱스

내장 명령어를 사용하여 MCP 서버를 Codex CLI에 추가하세요:

MCP Server Kubernetes

MCP Server that can connect to a Kubernetes cluster and manage it. Supports loading kubeconfig from multiple sources in priority order.

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

Installation & Usage

Prerequisites

Before using this MCP server with any tool, make sure you have:

1. kubectl installed and in your PATH
2. A valid kubeconfig file with contexts configured
3. Access to a Kubernetes cluster configured for kubectl (e.g. minikube, Rancher Desktop, GKE, etc.)
4. Helm v3 installed and in your PATH (no Tiller required). Optional if you don’t plan to use Helm.

You can verify your connection by running kubectl get pods in a terminal to ensure you can connect to your cluster without credential issues.

By default, the server loads kubeconfig from ~/.kube/config. For additional authentication options (environment variables, custom paths, etc.), see ADVANCED_README.md.

Claude Code

Add the MCP server to Claude Code using the built-in command:

claude mcp add kubernetes -- npx mcp-server-kubernetes

This will automatically configure the server in your Claude Code MCP settings.

Codex

Add the MCP server to Codex CLI using the built-in command:

codex mcp add kubernetes -- npx mcp-server-kubernetes

This registers the server globally in ~/.codex/config.toml and makes its tools available in all Codex sessions.

Claude Desktop

Add the following configuration to your Claude Desktop config file:

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["mcp-server-kubernetes"]
    }