Back to Home
Azure icon

mcp-kubernetes

Verified Safe

by Azure

Overview

Enables AI assistants to interact with and debug Kubernetes clusters by translating natural language requests into Kubernetes operations.

Installation

Run Command
docker run -i --rm --mount type=bind,src=/home/username/.kube/config,dst=/home/mcp/.kube/config ghcr.io/azure/mcp-kubernetes

Environment Variables

  • KUBECONFIG
  • USE_LEGACY_TOOLS
  • KUBERNETES_MCP_COLLECT_TELEMETRY
  • APPLICATIONINSIGHTS_INSTRUMENTATION_KEY

Security Notes

The server's core function is executing shell commands (kubectl, helm, cilium, hubble) based on AI input, which inherently carries security risks. However, the project implements strong mitigations: - Explicit `--access-level` controls (readonly, readwrite, admin) filter allowed operations at registration time. - `--allow-namespaces` restricts operations to specific namespaces, including regex support. - Command parsing uses `shlex.Split` to handle quotes and prevent basic injection, though an advanced AI could still generate harmful commands within its allowed scope. - Validation of CLI tools (`kubectl`, `helm`, `cilium`, `hubble`) and kubeconfig connectivity is performed at startup. - Telemetry collection is opt-out and sends basic invocation data. - The project follows Microsoft's security reporting policies.

Similar Servers

Stats

Interest Score33
Security Score8
Cost ClassLow
Stars47
Forks14
Last Update2025-12-30

Tags

KubernetesAI AgentDebuggingMCPCLI