MKP는 쿠버네티스의 모델 Context Protocol (MCP) 서버입니다. LLM-powered 응용 프로그램은 쿠버네티스 클러스터와 상호 작용합니다. 도구 제공 MCP 프로토콜을 통해 쿠버네티스 리소스를 나열하고 적용할 수 있습니다.

특징

• Kubernetes API 서버에서 지원하는 목록 리소스
• 클러스터링 리소스 목록
• Namespaced 리소스 목록
• 리소스 및 하위 자원 받기 (상태, 스케일, 로그 등 포함)
• 적용(create or update) 클러스터링 리소스
• Apply (create or update) 네임스페이스 리소스
• 타임아웃 컨트롤과 팟에서 명령 실행
• API Machinery의 unstructured 클라이언트를 사용하여 일반 및 플러그 가능 구현
• 과도한 API 호출에 대한 보호에 대한 내장 속도 제한

왜 MKP?

MKP는 모델 Context Protocol 서버로 몇 가지 주요 이점을 제공합니다. 쿠버네티스

Native Go 구현

• Kubernetes 자체와 같은 언어 내장
• 서버 애플리케이션의 우수한 성능 특성
• 강한 유형 안전 및 concurrency 지원
• Kubernetes 라이브러리의 원활한 통합

직접 API 통합

• 외부 의존도 없이 Kubernetes API Machinery를 직접 사용합니다

MKP - Model Kontext Protocol Server for Kubernetes

MKP is a Model Context Protocol (MCP) server for Kubernetes that allows LLM-powered applications to interact with Kubernetes clusters. It provides tools for listing and applying Kubernetes resources through the MCP protocol.

Features

• List resources supported by the Kubernetes API server
• List clustered resources
• List namespaced resources
• Get resources and their subresources (including status, scale, logs, etc.)
• Apply (create or update) clustered resources
• Apply (create or update) namespaced resources
• Execute commands in pods with timeout control
• Generic and pluggable implementation using API Machinery’s unstructured client
• Built-in rate limiting for protection against excessive API calls

Why MKP?

MKP offers several key advantages as a Model Context Protocol server for Kubernetes:

Native Go Implementation

• Built with the same language as Kubernetes itself
• Excellent performance characteristics for server applications
• Strong type safety and concurrency support
• Seamless integration with Kubernetes libraries

Direct API Integration

• Uses Kubernetes API machinery directly without external dependencies
• No reliance on kubectl, helm, or other CLI tools
• Communicates directly with the Kubernetes API server
• Reduced overhead and improved reliability

Universal Resource Support

• Works with any Kubernetes resource type through the unstructured client
• No hardcoded resource schemas or specialized handlers needed
• Automatically supports Custom Resource Definitions (CRDs)
• Future-proof for new Kubernetes resources

Minimalist Design

• Focused on core Kubernetes resource operations
• Clean, maintainable codebase with clear separation of concerns
• Lightweight with minimal dependencies
• Easy to understand, extend, and contribute to

Production-Ready Architecture

• Designed for reliability and performance in production environments
• Proper error handling and resource management
• Built-in rate limiting to protect against excessive API calls
• Testable design with comprehensive unit tests
• Follows Kubernetes development best practices

Prerequisites

• Go 1.24 or later
• Kubernetes cluster and kubeconfig
• Task for running tasks

Installation

1. Clone the repository:

   git clone https://github.com/StacklokLabs/mkp.git
   cd mkp
   

2. Install dependencies:

   task install
   

3. Build the server:

   task build
   

Usage

Running the server

To run the server with the default kubeconfig:

task run

To run the server with a specific kubeconfig:

KUBECONFIG=/path/to/kubeconfig task run-with-kubeconfig

To run the server on a specific port:

MCP_PORT=9091 task run

Running with ToolHive