mcp-k8s-go

local-only server

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

Integrations

Connects to Kubernetes clusters to list contexts, namespaces, nodes, resources (pods, services, deployments), fetch resource details, list events, and get pod logs

특징

MCP 💬 프롬프트 🗂️ 리소스 🤖 도구

🗂️🤖 Kubernetes 컨텍스트 나열
💬🤖 Kubernetes 네임스페이스 나열
🤖 Kubernetes 리소스를 나열하고 가져옵니다.
- 포드, 서비스, 배포와 같은 리소스에 대한 사용자 정의 매핑이 포함되지만 모든 리소스를 나열하고 검색할 수 있습니다.
🤖 쿠버네티스 노드 나열
💬 Kubernetes 포드 나열
🤖 Kubernetes 이벤트 가져오기
🤖 Kubernetes Pod 로그 가져오기
🤖 Kubernetes Pod에서 명령 실행

검사기로 탐색

Inspector에서 최신 게시 버전을 사용하려면 다음을 실행하세요.

지엑스피1

또는 소스에서 빌드된 버전을 사용하려면 이 프로젝트의 루트 폴더에서 다음을 수행합니다.

tools/inspector/run.sh

클로드와 함께 사용하세요

Claude Desktop과의 다음 채팅은 특정 컨텍스트를 리소스로 선택한 다음 kube-system 네임스페이스에서 오류가 있는지 Pod 로그를 확인하라는 요청을 받았을 때의 모습을 보여줍니다.

이 MCP 서버를 Claude Desktop(또는 다른 클라이언트)과 함께 사용하려면 어떤 설치 방법을 사용할지 선택해야 할 수도 있습니다.

여러 가지 옵션이 있습니다.

|대장간|mcp-get|사전 구축된 NPM|Github에 미리 빌드됨|출처에서|Docker 사용| |---|---|---|---|---|---|---| |클로드 셋업|자동|자동|수동|수동|수동|수동| |필수 조건|노드.js|노드.js|노드.js|없음|골랑|도커|

대장간 사용

Smithery를 통해 Claude Desktop용 MCP K8S Go를 자동으로 설치하려면:

npx -y @smithery/cli install @strowk/mcp-k8s --client claude

mcp-get 사용

mcp-get을 통해 Claude Desktop용 MCP K8S Go를 자동으로 설치하려면:

npx @michaellatman/mcp-get@latest install @strowk/mcp-k8s

미리 빌드된 바이너리를 사용하여 수동으로

npm에서 미리 빌드됨

npm이 설치되어 있고 미리 빌드된 바이너리를 사용하려는 경우 이것을 사용하세요.

npm install -g @strowk/mcp-k8s

그런 다음 mcp-k8s --version 실행하여 버전을 확인하고, 인쇄된 설치 버전이 나타나면 claude_desktop_config.json 파일에 구성을 추가할 수 있습니다.

{
  "mcpServers": {
    "mcp_k8s": {
      "command": "mcp-k8s",
      "args": []
    }
  }
}

또는 모든 클라이언트와 함께 npx 사용하세요:

npx @strowk/mcp-k8s

예를 들어 Claude의 경우:

{
  "mcpServers": {
    "mcp_k8s": {
      "command": "npx",
      "args": [
        "@strowk/mcp-k8s"
      ]
    }
  }
}

GitHub 릴리스에서

GitHub 릴리스 페이지 로 가서 해당 플랫폼에 맞는 최신 릴리스를 다운로드하세요.

mcp-k8s-go 라는 이름의 바이너리가 포함된 아카이브를 압축 해제하고 해당 바이너리를 PATH의 어딘가에 넣은 후 다음 구성을 claude_desktop_config.json 파일에 추가합니다.

{
  "mcpServers": {
    "mcp_k8s": {
      "command": "mcp-k8s-go",
      "args": []
    }
  }
}

소스에서 빌드

이 프로젝트를 빌드하려면 Golang을 설치해야 합니다.

go get github.com/strowk/mcp-k8s-go
go install github.com/strowk/mcp-k8s-go

그런 다음 claude_desktop_config.json 파일에 다음 구성을 추가합니다.

{
  "mcpServers": {
    "mcp_k8s_go": {
      "command": "mcp-k8s-go",
      "args": []
    }
  }
}

Docker 사용

이 서버는 0.3.1-beta.2 릴리스 이후 Docker Hub에 빌드 및 게시되었으며 linux/amd64 및 linux/arm64 아키텍처에 대한 다중 아키텍처 이미지가 제공됩니다.

최신 태그 fe를 다음과 같이 사용할 수 있습니다:

docker run -i -v ~/.kube/config:/home/nonroot/.kube/config --rm mcpk8s/server:latest

Windows 사용자는 최소한 Git Bash에서 ~/.kube/config //c/Users/<username>/.kube/config 로 바꿔야 할 수도 있습니다.

클로드에게:

{
  "mcpServers": {
    "mcp_k8s_go": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-v",
        "~/.kube/config:/home/nonroot/.kube/config",
        "--rm",
        "mcpk8s/server:latest"
      ]
    }
  }
}

환경 변수 및 명령줄 옵션

MCP 서버에서는 다음 환경 변수를 사용합니다.

KUBECONFIG : Kubernetes 구성 파일 경로(선택 사항, 기본값은 ~/.kube/config)

다음 명령줄 옵션이 지원됩니다.

--allowed-contexts=<ctx1,ctx2,...> : 사용자가 액세스할 수 있는 Kubernetes 컨텍스트를 쉼표로 구분하여 나열합니다. 지정하지 않으면 모든 컨텍스트가 허용됩니다.
--help : 도움말 정보를 표시합니다.
--version : 버전 정보 표시

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

이 프로젝트는 Kubernetes에 연결하는 MCP 서버이자 Kubernetes의 모든 사용자 정의 리소스에 대한 추가 서버를 구축하기 위한 라이브러리로 의도되었습니다.