Kubernetes Management MCP Server

Overview

Kubernetes Management allows you to interact with and manage your Kubernetes clusters directly through your AI assistant. This powerful integration enables you to perform common Kubernetes operations using natural language instead of remembering complex kubectl commands and syntax.

Prerequisites

Before using this tool, ensure you have:

1. kubectl installed and available in your PATH
2. A valid kubeconfig file with properly configured contexts
3. Access to a Kubernetes cluster (minikube, Rancher Desktop, GKE, EKS, AKS, etc.)
4. Helm v3 installed and in your PATH (optional, only needed for Helm operations)

Installation

To use the Kubernetes Management MCP with Claude Desktop, add the following configuration to your Claude Desktop config file:

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["mcp-server-kubernetes"]
    }
  }
}

The config file is typically located at:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Alternative Usage with mcp-chat

You can also use this tool with mcp-chat, a CLI chat client for MCP servers:

npx mcp-chat --server "npx mcp-server-kubernetes"

Or by referencing your existing Claude Desktop configuration:

# Mac
npx mcp-chat --config "~/Library/Application Support/Claude/claude_desktop_config.json"

# Windows
npx mcp-chat --config "%APPDATA%\Claude\claude_desktop_config.json"

Verifying Connection

After installation, you can verify your connection by asking your AI assistant to list your pods or namespaces. If you encounter any errors, try running kubectl get pods in a terminal to check if you can connect to your cluster without credential issues.

Usage Examples

Here are some examples of what you can ask your AI assistant to do with Kubernetes Management:

• "List all pods in the default namespace"
• "Create a new deployment with 3 replicas of nginx"
• "Scale the frontend deployment to 5 replicas"
• "Show me the logs for the database pod"
• "Install the Prometheus Helm chart"
• "Create a ConfigMap with these environment variables"
• "Delete the test namespace and all its resources"

Troubleshooting

If you encounter issues:

1. Authentication Problems: Ensure your kubeconfig is properly set up and you have the necessary permissions
2. Context Issues: Verify you're using the correct kubectl context with kubectl config current-context
3. Helm Errors: Make sure Helm v3 is installed and properly configured
4. Path Problems: Confirm kubectl and helm are in your system PATH

For more advanced usage and configuration options, refer to the project's GitHub repository.