K8s MCP Server

مجتمعي السحابة وDevOps

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

التثبيت

خطوات التثبيت موجودة في التوثيق أدناه. التوثيق

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو K8s MCP Server؟

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

كيف أثبّت K8s MCP Server؟

اتبع خطوات التثبيت في توثيقه المعروض في هذه الصفحة وفي مستودعه.

هل K8s MCP Server مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون K8s MCP Server؟

ينشره akkireddy-challa. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من القوائم المجتمعية awesome-mcp-servers ومستودع المشروع على GitHub. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.