MKP - это сервер протокола Model Context Protocol (MCP) для Kubernetes. LLM-приложения для взаимодействия с кластерами Kubernetes. предоставляет инструменты Перечисление и применение ресурсов Kubernetes через протокол MCP.

Особенности

Список ресурсов, поддерживаемых API-сервером Kubernetes

• Перечислить кластерные ресурсы
• Перечислить пространные ресурсы Получите ресурсы и их подресурсы (включая статус, масштаб, журналы и т. Д.) Применять (создавать или обновлять) кластерные ресурсы
• Применять (создавать или обновлять) ресурсы, расположенные в пространстве имен Выполнять команды в капсулах с контролем тайм-аута
• Общая и подключаемая реализация с использованием неструктурированного клиента API Machinery Встроенное ограничение скорости для защиты от чрезмерных вызовов API

##Почему МКП?

MKP предлагает несколько ключевых преимуществ в качестве сервера протокола Model Context. Кубернетес:

Реализация Native Go

Построен на том же языке, что и сам Куберне. Отличная производительность для серверных приложений

• Сильный тип безопасности и поддержка параллелизма Бесшовная интеграция с библиотеками Kubernetes

###Прямая интеграция API

Использует API-машины Kubernetes напрямую без внешних зависимостей

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