mcp-k8s

Overview

mcp-k8s is a comprehensive MCP server that enables interaction with Kubernetes clusters through MCP tools. It provides resource type queries, CRUD operations for Kubernetes resources, and Helm release management. The server supports multiple communication modes including stdio, SSE, and streamable HTTP, making it flexible for different integration scenarios. The implementation is written in Go using the mcp-go SDK, Kubernetes client-go library, and Helm v3 client library.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_api_resources

  Get all supported API resource types in the cluster

  Try:List all available Kubernetes resource typesTry:Show me the API resources supported by this cluster
• get_resource

  Get detailed information about a specific resource

  Try:Get details of the deployment named my-appTry:Show information about pod nginx-123
• list_resources

  List all instances of a resource type

  Try:List all deployments in the current namespaceTry:Show me all pods in the cluster
• create_resource

  Create new Kubernetes resources

  Try:Create a new deployment with 3 replicasTry:Create a namespace named test-namespace
• update_resource

  Update existing Kubernetes resources

  Try:Update the image of my-app deployment to nginx:1.20Try:Scale the deployment to 5 replicas
• delete_resource

  Delete Kubernetes resources

  Try:Delete the pod named nginx-123Try:Remove the namespace named test-namespace
• list_helm_releases

  List all Helm releases in the cluster

  Try:Show all Helm releases in the current namespaceTry:List all Helm releases across all namespaces
• get_helm_release

  Get detailed information about a specific Helm release

  Try:Get details of the Helm release my-appTry:Show the status of the nginx release
• install_helm_chart

  Install a Helm chart

  Try:Install the nginx chart with custom valuesTry:Deploy the postgresql chart to the production namespace
• upgrade_helm_chart

  Upgrade a Helm release

  Try:Upgrade the my-app release to the latest versionTry:Update the nginx release to chart version 2.0
• uninstall_helm_chart

  Uninstall a Helm release

  Try:Remove the Helm release named my-appTry:Uninstall the nginx release
• list_helm_repositories

  List configured Helm repositories

  Try:Show all configured Helm repositoriesTry:List the repositories available in Helm

Comparable tools

Installation

go install github.com/silenceper/mcp-k8s/cmd/mcp-k8s@latest

git clone https://github.com/silenceper/mcp-k8s.git
cd mcp-k8s
make build

{
  "mcpServers": {
    "mcp-k8s": {
      "command": "/path/to/mcp-k8s",
      "args": [
        "--kubeconfig",
        "/path/to/kubeconfig",
        "--enable-create",
        "--enable-delete",
        "--enable-update",
        "--enable-list"
      ]
    }
  }
}

FAQ

How do I enable write operations for Kubernetes resources?

Write operations are disabled by default. You can enable them with command line arguments: --enable-create, --enable-update, --enable-delete. For example: mcp-k8s --enable-create --enable-update --enable-delete

Can I use mcp-k8s with Helm charts?

Yes, mcp-k8s includes comprehensive Helm support with operations for releases (list, get, install, upgrade, uninstall) and repositories (list, add, remove). Write operations for Helm are disabled by default.

Compare mcp-k8s with