Skip to main content
Glama

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables advanced management of Kubernetes clusters through natural language interactions. Supports querying, managing, and monitoring pods, deployments, nodes, and logs across multiple contexts and namespaces.
      10
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables comprehensive Kubernetes cluster management through kubectl operations, Helm chart deployments, pod troubleshooting, and node management. Supports both read-only and full cluster administration capabilities with built-in safety features.
      16,349 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to interact with and manage Kubernetes clusters, supporting operations on pods, deployments, services, configmaps, secrets, namespaces, metrics, and events with built-in safety features for destructive actions.
      9
      7 npm
      1
      MIT