local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Allows viewing and managing Kubernetes resources including configuration, generic resources, and pods. Supports operations like CRUD on any Kubernetes resource, listing/getting/deleting pods, showing pod logs, and running container images.

쿠버네티스 MCP 서버

✨ 기능 | 🚀 시작하기 | 🎥 데모 | ⚙️ 구성 | 🧑‍💻 개발

https://github.com/user-attachments/assets/be2b67b3-fc1c-4d11-ae46-93deba8ed98e

✨ 특징

Kubernetes 와 OpenShift를 지원하는 강력하고 유연한 Kubernetes Model Context Protocol(MCP) 서버 구현입니다.

✅ 구성 :
- Kubernetes 구성의 변경 사항을 자동으로 감지하고 MCP 서버를 업데이트합니다.
- 현재 Kubernetes .kube/config 또는 클러스터 내 구성을 보고 관리합니다.
✅ 일반 Kubernetes 리소스 : 모든 Kubernetes 또는 OpenShift 리소스에 대한 작업을 수행합니다.
- 모든 CRUD 작업(생성 또는 업데이트, 가져오기, 나열, 삭제).
✅ Pod : Pod별 작업을 수행합니다.
- 모든 네임스페이스 또는 특정 네임스페이스의 포드를 나열합니다 .
- 지정된 네임스페이스에서 이름으로 포드를 가져옵니다 .
- 지정된 네임스페이스에서 이름으로 Pod를 삭제합니다 .
- 지정된 네임스페이스에서 이름으로 Pod에 대한 로그를 표시합니다 .
- 포드에 exec를 넣고 명령을 실행합니다.
- 포드에서 컨테이너 이미지를 실행 하고 선택적으로 노출합니다.
✅ 네임스페이스 : Kubernetes 네임스페이스를 나열합니다.
✅ 이벤트 : 모든 네임스페이스 또는 특정 네임스페이스의 Kubernetes 이벤트를 확인합니다.
✅ 프로젝트 : OpenShift 프로젝트를 나열하세요.

다른 Kubernetes MCP 서버 구현과 달리 이것은 단순히 kubectl 이나 helm 명령줄 도구를 감싸는 래퍼가 아닙니다 .

시스템에 외부 종속성이나 도구를 설치할 필요가 없습니다 . 네이티브 바이너리를 사용한다면 시스템에 Node.js나 Python을 설치할 필요도 없습니다.

🚀 시작하기

요구 사항

Kubernetes 클러스터에 액세스합니다.

클로드 데스크탑

npx 사용하기

npm이 설치되어 있다면 Claude Desktop에서 kubernetes-mcp-server 시작하는 가장 빠른 방법입니다.

claude_desktop_config.json 열고 mcpServers 목록에 mcp 서버를 추가합니다.

지엑스피1

VS 코드 / VS 코드 인사이더

다음 링크를 눌러 VS Code Insiders에서 Kubernetes MCP 서버 확장 프로그램을 설치하세요.

또는 다음 명령을 실행하여 확장 프로그램을 수동으로 설치할 수 있습니다.

# For VS Code
code --add-mcp '{"name":"kubernetes","command":"npx","args":["kubernetes-mcp-server@latest"]}'
# For VS Code Insiders
code-insiders --add-mcp '{"name":"kubernetes","command":"npx","args":["kubernetes-mcp-server@latest"]}'

구스 CLI

Goose CLI는 인공지능(AI) 에이전트를 사용하는 가장 쉽고 저렴한 방법입니다.

npm 사용하기

npm이 설치되어 있다면 kubernetes-mcp-server 시작하는 가장 빠른 방법입니다.

goose config.yaml 열고 mcpServers 목록에 mcp 서버를 추가합니다.

extensions:
  kubernetes:
    command: npx
    args:
      - -y
      - kubernetes-mcp-server@latest

🎥 데모

OpenShift 배포 진단 및 자동 수정

Claude Desktop이 Kubernetes MCP 서버를 활용하여 사용자 지원 없이 OpenShift에서 배포를 자동으로 진단하고 수정하는 방법을 보여주는 데모입니다.

https://github.com/user-attachments/assets/a576176d-a142-4c19-b9aa-a83dc4b8d941

간단한 게임을 Vibe 코딩 하여 OpenShift에 배포

이 데모에서는 VS Code를 사용하여 간단한 게임을 Vibe Coding하는 과정과 Podman MCP 서버 와 Kubernetes MCP 서버를 활용하여 이를 OpenShift에 배포하는 방법을 안내해 드립니다.

⚙️ 구성

Kubernetes MCP 서버는 명령줄(CLI) 인수를 사용하여 구성할 수 있습니다.

npx 사용하거나 최신 릴리스 바이너리를 다운로드하여 CLI 실행 파일을 실행할 수 있습니다.

# Run the Kubernetes MCP server using npx (in case you have npm installed)
npx kubernetes-mcp-server@latest --help

# Run the Kubernetes MCP server using the latest release binary
./kubernetes-mcp-server --help

구성 옵션

옵션	설명
`--sse-port`	MCP 서버를 SSE(Server-Sent Event) 모드로 시작하고 지정된 포트에서 수신 대기합니다.
`--log-level`	로깅 수준을 설정합니다( 0~9 ). kubectl 로깅 수준 과 유사합니다.

🧑‍💻 개발

mcp-inspector로 실행

프로젝트를 컴파일하고 mcp-inspector 로 Kubernetes MCP 서버를 실행하여 MCP 서버를 검사합니다.

# Compile the project
make build
# Run the Kubernetes MCP server with mcp-inspector
npx @modelcontextprotocol/inspector@latest $(pwd)/kubernetes-mcp-server

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

OpenShift를 지원하는 강력하고 유연한 Kubernetes MCP 서버 구현입니다.

Related Resources

Reddit Discussion about this server