freemcplab / 디렉터리 / 플레이그라운드 / MKP (Model Kontext for K8s)

● 공식 StacklokLabs ⚡ 바로 사용

MKP (Model Kontext for K8s)

Name: MKP (Model Kontext for K8s) MCP Server
Author: StacklokLabs

제작: StacklokLabs · StacklokLabs/mkp

Kubernetes MCP from Stacklok — native API client, not a kubectl wrapper.

MKP is a Kubernetes MCP server written in Go that talks directly to the API server (not by shelling out to kubectl). That means structured outputs, less prompt pollution, and proper RBAC enforcement based on the agent's serviceaccount.

▶ 데모 보기 📦 설치 💡 사용 사례

왜 쓰나요

핵심 기능

Native client-go — structured JSON outputs, no kubectl text parsing
Read pods/services/deployments + logs + events
Apply manifests with dry-run support
RBAC-aware: only exposes verbs the bound serviceaccount has
Multi-context support via kubeconfig

라이브 데모

실제 사용 모습

mkp-mcp.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mkp-mcp": {
      "command": "mkp",
      "args": [
        "serve"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mkp-mcp": {
      "command": "mkp",
      "args": [
        "serve"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mkp-mcp": {
      "command": "mkp",
      "args": [
        "serve"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mkp-mcp": {
      "command": "mkp",
      "args": [
        "serve"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mkp-mcp",
      "command": "mkp",
      "args": [
        "serve"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "mkp-mcp": {
      "command": {
        "path": "mkp",
        "args": [
          "serve"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add mkp-mcp -- mkp serve

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: MKP (Model Kontext for K8s)

Find which pod is OOMKilling and propose a fix

👤 K8s operators ⏱ ~15 min intermediate

언제 쓸까: You're paged for memory pressure and don't have a dashboard up.

사전 조건

Server/skill installed and authenticated — See repo README

흐름

Spot the OOMs

Find pods in any namespace with restartCount > 3 in the last hour. Show pod, namespace, last termination reason.✓ 복사됨

→ Targeted list, likely with OOMKilled in the reason
Propose the fix

Get the limits/requests for the worst offender. Tell me what to raise and write an apply_manifest dry-run patch.✓ 복사됨

→ Resource diff + a dry-run apply

결과: Targeted patch ready to apply, RBAC-checked.

함정

MKP only exposes what the bound SA can do — MKP only exposes what the bound SA can do — to enable apply_manifest you must bind an SA with patch permission.

함께 쓰기: portainer-mcp

조합

다른 MCP와 조합해 10배 효율

mkp-mcp + portainer-mcp

Pair with portainer-mcp for complementary capabilities

Use this server together with portainer-mcp to complete a multi-step task.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
list_resources	kind, namespace, label_selector	Inventory any resource type	1 API call
get_logs	pod, container, tail_lines	Triage a pod	1 API call
apply_manifest	yaml, dry_run	Deploy a change (dry-run first)	1 API call

비용 및 제한

운영 비용

API 쿼터: See provider docs for rate limits
호출당 토큰: Varies by tool
금액: See repo README for pricing details
팁: Cache tool results and avoid repeated identical calls.

보안

권한, 시크릿, 파급범위

자격 증명 저장: Use environment variables; never commit secrets

데이터 외부 송신: Tool calls go to the provider's API as documented

문제 해결

자주 발생하는 오류와 해결

Forbidden on list pods

Bind a Role/ClusterRole with pods:get,list,watch to the SA mkp uses. Use kubectl auth can-i to verify.

확인: kubectl auth can-i list pods

context not found

Set KUBECONFIG to a file with the right context, or pass --context.

확인: kubectl config get-contexts

대안