English Français العربية

K8s MCP Server

Community Cloud and DevOps

Kubernetes cluster operations: inspect pods, deployments, services and logs.

Source code Documentation

Install

The installation steps are in the documentation below. Documentation

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. k8s-mcp-server
  2. What is this?
  3. Available Tools
  4. Quick Start
  5. Security Model
  6. License

k8s-mcp-server

Production-ready Kubernetes diagnostics and cluster observability MCP server for AI agents.

What is this?

k8s-mcp-server is a Model Context Protocol (MCP) server providing automated, read-only diagnostic tools for inspecting Kubernetes clusters. It allows AI agents to troubleshoot pod crashes, inspect ingress routes, and analyze cluster-wide warning events safely.

Available Tools

ToolCategoryDescription
get_cluster_nodesInfrastructureLists nodes, readiness states, roles, and kubelet versions.
get_pod_diagnosticsWorkloadsDetects abnormal pod phases, restart loops, and CrashLoopBackOffs.
get_pod_logsObservabilityRetrieves container stdout/stderr logs with tail limits and crash inspection.
list_warning_eventsDiagnosticsAggregates FailedScheduling, FailedMount, and BackOff warning events.
list_ingressesNetworkingAudits HTTP routing rules, host headers, and TLS certificates.

Quick Start

Prerequisites
  • Python 3.11+
  • Active Kubernetes cluster access (~/.kube/config or in-cluster ServiceAccount)
  • Read-only RBAC privileges (get, list on core and networking API groups)
Run Locally
git clone https://github.com/akkireddy-challa/k8s-mcp-server.git
cd k8s-mcp-server
pip install -r requirements.txt
python server.py
Claude Desktop Configuration

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "kubernetes": {
      "command": "python",
      "args": ["/path/to/k8s-mcp-server/server.py"],
      "env": {
        "KUBECONFIG": "/Users/<username>/.kube/config"
      }
    }
  }
}

Security Model

  • Strictly Read-Only: Enforces GET and LIST operations only.
  • Zero-Secret Exposure: Secrets and config maps are never inspected or surfaced to LLM context.
  • Flexible Auth: Supports standard ~/.kube/config context or in-cluster pod ServiceAccounts.

License

MIT License. See LICENSE for details.

Built by Akkireddy Challa — Platform Engineer at Telia, Stockholm.

Frequently asked questions

What is K8s MCP Server?

Kubernetes cluster operations: inspect pods, deployments, services and logs.

How do I install K8s MCP Server?

Follow the installation steps in its documentation, shown on this page and in its repository.

Is K8s MCP Server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains K8s MCP Server?

It is published by akkireddy-challa. AI.tn lists it but does not maintain or endorse it.

From the community awesome-mcp-servers lists and the project's GitHub repository. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.