K8s MCP

A Kubernetes assistant powered by Model Context Protocol (MCP) and Google Gemini.

Requirements

• Python 3.10+

• Kubernetes cluster with kubeconfig configured

Related MCP server: Kubernetes MCP Server

Quick Start

Use the Makefile to run different components:

1. MCP Server

Starts the MCP server that communicates with your Kubernetes cluster.

make mcp-server

Requires: Active Kubernetes cluster and configured kubeconfig.

2. CLI Mode

Interactive command-line interface to query your Kubernetes cluster.

make cli

Project Structure

k8s_mcp_server.py    - MCP server implementation
mcp_client.py        - CLI client

Configuration

Ensure your kubeconfig is at ~/.kube/config or set the KUBECONFIG environment variable.

The MCP server exposes 32+ Kubernetes tools for managing resources, deployments, services, and more, including long-running background tasks.

Features

• Real-time Kubernetes operations via MCP tools

• Interactive chat interface with tool call results

• Inline tool call display in messages

• Background task execution and asynchronous event streaming

• Session persistence

Make Commands

Available make targets (run make <target>):

• make help — Show all available commands

• make mcp-server — Start the K8s MCP server

• make cli — Launch the interactive CLI client

• make clean — Remove build artifacts and cache files