k8s-mcp-assistant

A read-only Kubernetes MCP (Model Context Protocol) server to help developers quickly inspect the state of their apps in a dev cluster — without giving them full kubectl access.

Built for teams where only Cloud/SRE has cluster access, but developers still need answers like:

• “Why is my app in CrashLoopBackOff?”

• “What do the pod events say?”

• “Show me the container logs (including --previous)”

What it does

This MCP exposes safe, read-only tools that fetch Kubernetes status and logs from a cluster using a restricted kubeconfig / ServiceAccount.

Tools

• k8s.app_status

  • Shows a high-level view of an app (deploy/pods readiness, restarts, basic diagnostics)

• k8s.pod_logs

  • Fetches pod logs with practical options like tail, since, timestamps, container, and previous

⚠️ This project is intentionally read-only: no apply, no delete, no exec, no port-forward, no secret retrieval.

Quickstart (local)

1) Clone & install