kubectl-mcp-server 1.19.3 → 1.22.0

package/README.md

@@ -21,7 +21,8 @@ Talk to your clusters like you talk to a DevOps expert. Debug crashed pods, opti
   <a href="https://pypi.org/project/kubectl-mcp-server/"><img src="https://img.shields.io/pypi/v/kubectl-mcp-server?color=blue&label=PyPI" alt="PyPI"></a>
   <a href="https://www.npmjs.com/package/kubectl-mcp-server"><img src="https://img.shields.io/npm/v/kubectl-mcp-server?color=green&label=npm" alt="npm"></a>
   <a href="https://hub.docker.com/r/rohitghumare64/kubectl-mcp-server"><img src="https://img.shields.io/docker/pulls/rohitghumare64/kubectl-mcp-server.svg" alt="Docker"></a>
-  <a href="https://github.com/rohitg00/kubectl-mcp-server"><img src="https://img.shields.io/badge/tests-234%20passed-success" alt="Tests"></a>
+  <a href="https://github.com/rohitg00/kubectl-mcp-server"><img src="https://img.shields.io/badge/tests-234%20passed-success" 
+  <a href="https://deepwiki.com/rohitg00/kubectl-mcp-server"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
   <a href="https://aregistry.ai"><img src="https://img.shields.io/badge/agentregistry-verified-blue?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgZmlsbD0id2hpdGUiIHZpZXdCb3g9IjAgMCAxNiAxNiI+PHBhdGggZD0iTTE1Ljk5MiA2LjAzN2wtMy4wMjEtLjQzOS0xLjM1LTIuNzM2Yy0uMzQ2LS43MDItMS41MDQtLjcwMi0xLjg1IDBMOC40MjEgNS41OTggNS40IDYuMDM3Yy0uNzc2LjExMy0xLjA4OCAxLjA1My0uNTI4IDEuNTkzbDIuMTg2IDIuMTI5LS41MTYgMy4wMWMtLjEzMy43NzUuNjgyIDEuMzY2IDEuMzc4Ljk5OGwyLjcwMi0xLjQyIDIuNzAyIDEuNDJjLjY5Ni4zNjggMS41MTEtLjIyMyAxLjM3OC0uOTk4bC0uNTE2LTMuMDEgMi4xODYtMi4xMjljLjU2LS41NCAwLjI0OC0xLjQ4LS41MjgtMS41OTN6Ii8+PC9zdmc+" alt="agentregistry"></a>
 </p>
 
@@ -108,7 +109,7 @@ Simply ask your AI assistant in natural language:
 - Interactive HTML dashboards with live metrics
 - Visual timeline of events and resource usage
 
-**224 powerful tools** | **8 workflow prompts** | **8 data resources** | **Works with all major AI assistants**
+**253 powerful tools** | **8 workflow prompts** | **8 data resources** | **Works with all major AI assistants**
 
 ## Why kubectl-mcp-server?
 
@@ -178,9 +179,12 @@ pip install git+https://github.com/rohitg00/kubectl-mcp-server.git
 ### Docker
 
 ```bash
-# Pull and run with Docker
+# Pull from Docker Hub
 docker pull rohitghumare64/kubectl-mcp-server:latest
 
+# Or pull from GitHub Container Registry
+docker pull ghcr.io/rohitg00/kubectl-mcp-server:latest
+
 # Run with stdio transport
 docker run -i -v $HOME/.kube:/root/.kube:ro rohitghumare64/kubectl-mcp-server:latest
 
@@ -422,7 +426,7 @@ Add to `~/.config/roo-code/mcp.json` or `~/.config/kilo-code/mcp.json`:
 
 ## Complete Feature Set
 
-### 224 MCP Tools for Complete Kubernetes Management
+### 253 MCP Tools for Complete Kubernetes Management
 
 | Category | Tools |
 |----------|-------|
@@ -457,6 +461,8 @@ Add to `~/.config/roo-code/mcp.json` or `~/.config/kilo-code/mcp.json`:
 | **Cluster API** | `capi_clusters_list`, `capi_cluster_get`, `capi_machines_list`, `capi_machine_get`, `capi_machinedeployments_list`, `capi_machinedeployment_scale`, `capi_machinesets_list`, `capi_machinehealthchecks_list`, `capi_clusterclasses_list`, `capi_cluster_kubeconfig`, `capi_detect` |
 | **KubeVirt VMs** | `kubevirt_vms_list`, `kubevirt_vm_get`, `kubevirt_vmis_list`, `kubevirt_vm_start`, `kubevirt_vm_stop`, `kubevirt_vm_restart`, `kubevirt_vm_pause`, `kubevirt_vm_unpause`, `kubevirt_vm_migrate`, `kubevirt_datasources_list`, `kubevirt_instancetypes_list`, `kubevirt_datavolumes_list`, `kubevirt_detect` |
 | **Istio/Kiali** | `istio_virtualservices_list`, `istio_virtualservice_get`, `istio_destinationrules_list`, `istio_gateways_list`, `istio_peerauthentications_list`, `istio_authorizationpolicies_list`, `istio_proxy_status`, `istio_analyze`, `istio_sidecar_status`, `istio_detect` |
+| **vCluster (vind)** | `vind_detect_tool`, `vind_list_clusters_tool`, `vind_status_tool`, `vind_get_kubeconfig_tool`, `vind_logs_tool`, `vind_create_cluster_tool`, `vind_delete_cluster_tool`, `vind_pause_tool`, `vind_resume_tool`, `vind_connect_tool`, `vind_disconnect_tool`, `vind_upgrade_tool`, `vind_describe_tool`, `vind_platform_start_tool` |
+| **kind (K8s in Docker)** | `kind_detect_tool`, `kind_version_tool`, `kind_list_clusters_tool`, `kind_get_nodes_tool`, `kind_get_kubeconfig_tool`, `kind_export_logs_tool`, `kind_cluster_info_tool`, `kind_node_labels_tool`, `kind_create_cluster_tool`, `kind_delete_cluster_tool`, `kind_delete_all_clusters_tool`, `kind_load_image_tool`, `kind_load_image_archive_tool`, `kind_build_node_image_tool`, `kind_set_kubeconfig_tool` |
 
 ### MCP Resources
 
@@ -496,12 +502,12 @@ Pre-built workflow prompts for common Kubernetes operations:
 
 ### Key Capabilities
 
-- 🤖 **224 Powerful Tools** - Complete Kubernetes management from pods to security
+- 🤖 **253 Powerful Tools** - Complete Kubernetes management from pods to security
 - 🎯 **8 AI Workflow Prompts** - Pre-built workflows for common operations
 - 📊 **8 MCP Resources** - Browsable Kubernetes data exposure
 - 🎨 **6 Interactive Dashboards** - HTML UI tools for visual cluster management
 - 🌐 **26 Browser Tools** - Web automation with cloud provider support
-- 🔄 **93 Ecosystem Tools** - GitOps, Cert-Manager, Policy, Backup, KEDA, Cilium, Rollouts, CAPI, KubeVirt, Istio
+- 🔄 **107 Ecosystem Tools** - GitOps, Cert-Manager, Policy, Backup, KEDA, Cilium, Rollouts, CAPI, KubeVirt, Istio, vCluster
 - ⚡ **Multi-Transport** - stdio, SSE, HTTP, streamable-http
 - 🔐 **Security First** - Non-destructive mode, secret masking, RBAC validation
 - 🏥 **Advanced Diagnostics** - AI-powered troubleshooting and cost optimization
@@ -668,6 +674,54 @@ kubectl-mcp-server
 - Remote CDP connections
 - Session management
 
+## Optional: kubectl-mcp-app (8 Interactive UI Dashboards)
+
+A standalone npm package that provides beautiful, interactive UI dashboards for Kubernetes management using the MCP ext-apps SDK.
+
+**Installation:**
+
+```bash
+# Via npm
+npm install -g kubectl-mcp-app
+
+# Or via npx (no install)
+npx kubectl-mcp-app
+```
+
+**Claude Desktop Configuration:**
+
+```json
+{
+  "mcpServers": {
+    "kubectl-app": {
+      "command": "npx",
+      "args": ["kubectl-mcp-app"]
+    }
+  }
+}
+```
+
+**8 Interactive UI Tools:**
+
+| Tool | Description |
+| ---- | ----------- |
+| `k8s-pods` | Interactive pod viewer with filtering, sorting, status indicators |
+| `k8s-logs` | Real-time log viewer with syntax highlighting and search |
+| `k8s-deploy` | Deployment dashboard with rollout status, scaling, rollback |
+| `k8s-helm` | Helm release manager with upgrade/rollback actions |
+| `k8s-cluster` | Cluster overview with node health and resource metrics |
+| `k8s-cost` | Cost analyzer with waste detection and recommendations |
+| `k8s-events` | Events timeline with type filtering and grouping |
+| `k8s-network` | Network topology graph showing Services/Pods/Ingress |
+
+**Features:**
+- 🎨 Dark/light theme support
+- 📊 Real-time data visualization
+- 🖱️ Interactive actions (scale, restart, delete)
+- 🔗 Seamless integration with kubectl-mcp-server
+
+**More Info**: See [kubectl-mcp-app/README.md](./kubectl-mcp-app/README.md) for full documentation.
+
 ## Enterprise: OAuth 2.1 Authentication
 
 Secure your MCP server with OAuth 2.1 authentication (RFC 9728).
@@ -736,7 +790,7 @@ EOF
 agentgateway --config gateway.yaml
 ```
 
-Connect clients to `http://localhost:3000/mcp` for unified access to all 224 tools.
+Connect clients to `http://localhost:3000/mcp` for unified access to all 253 tools.
 
 ## In-Cluster Deployment
 
@@ -795,7 +849,7 @@ kubectl apply -f deploy/kagent/toolserver-stdio.yaml
 kagent dashboard
 ```
 
-Your AI agents now have access to all 224 Kubernetes tools. See [kagent quickstart](https://kagent.dev/docs/kagent/getting-started/quickstart).
+Your AI agents now have access to all 253 Kubernetes tools. See [kagent quickstart](https://kagent.dev/docs/kagent/getting-started/quickstart).
 
 ## Architecture
 
@@ -813,7 +867,7 @@ The MCP server implements the [Model Context Protocol](https://github.com/modelc
 ```
 kubectl_mcp_tool/
 ├── mcp_server.py          # Main server (FastMCP, transports)
-├── tools/                  # 224 MCP tools organized by category
+├── tools/                  # 253 MCP tools organized by category
 │   ├── pods.py            # Pod management & diagnostics
 │   ├── deployments.py     # Deployments, StatefulSets, DaemonSets
 │   ├── core.py            # Namespaces, ConfigMaps, Secrets
@@ -835,15 +889,16 @@ kubectl_mcp_tool/
 │   ├── rollouts.py        # Argo Rollouts/Flagger
 │   ├── capi.py            # Cluster API
 │   ├── kubevirt.py        # KubeVirt VMs
-│   └── kiali.py           # Istio/Kiali service mesh
+│   ├── kiali.py           # Istio/Kiali service mesh
+│   └── vind.py            # vCluster (virtual clusters)
 ├── resources/              # 8 MCP Resources for data exposure
 ├── prompts/                # 8 MCP Prompts for workflows
 └── cli/                    # CLI interface
 ```
 
-## Agent Skills (24 Skills for AI Coding Agents)
+## Agent Skills (25 Skills for AI Coding Agents)
 
-Extend your AI coding agent with Kubernetes expertise using our [Agent Skills](https://agentskills.io) library. Skills provide specialized knowledge and workflows that agents can load on demand.
+Extend your AI coding agent with Kubernetes expertise using our [Agent Skills](https://agenstskills.com) library. Skills provide specialized knowledge and workflows that agents can load on demand.
 
 ### Quick Install
 
@@ -855,7 +910,7 @@ cp -r kubernetes-skills/claude/* ~/.claude/skills/
 cp -r kubernetes-skills/claude/k8s-helm ~/.claude/skills/
 ```
 
-### Available Skills (24)
+### Available Skills (25)
 
 | Category | Skills |
 |----------|--------|
@@ -865,7 +920,7 @@ cp -r kubernetes-skills/claude/k8s-helm ~/.claude/skills/
 | **Security** | k8s-security, k8s-policy, k8s-certs |
 | **GitOps** | k8s-gitops, k8s-rollouts |
 | **Scaling** | k8s-autoscaling, k8s-cost, k8s-backup |
-| **Multi-Cluster** | k8s-multicluster, k8s-capi, k8s-kubevirt |
+| **Multi-Cluster** | k8s-multicluster, k8s-capi, k8s-kubevirt, k8s-vind |
 | **Networking** | k8s-service-mesh, k8s-cilium |
 | **Tools** | k8s-browser, k8s-cli |
 
@@ -893,7 +948,8 @@ Seamlessly manage multiple Kubernetes clusters through natural language. **Every
 
 ### Context Parameter (v1.15.0)
 
-All 224 tools accept an optional `context` parameter to target specific clusters:
+Most kubectl-backed tools accept an optional `context` parameter to target specific clusters.
+Note: vCluster (vind) and kind tools run via their local CLIs and do not accept the `context` parameter.
 
 **Talk to your AI assistant:**
 ```
@@ -982,7 +1038,7 @@ pytest tests/ -v -m unit
 tests/
 ├── __init__.py          # Test package
 ├── conftest.py          # Shared fixtures and mocks
-├── test_tools.py        # Unit tests for 224 MCP tools
+├── test_tools.py        # Unit tests for 253 MCP tools
 ├── test_resources.py    # Tests for 8 MCP Resources
 ├── test_prompts.py      # Tests for 8 MCP Prompts
 └── test_server.py       # Server initialization tests

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kubectl-mcp-server",
-  "version": "1.19.3",
-  "description": "A Model Context Protocol (MCP) server for Kubernetes with 235+ tools, 8 resources, and 8 prompts for AI assistants",
+  "version": "1.22.0",
+  "description": "A Model Context Protocol (MCP) server for Kubernetes with 270+ tools, 8 resources, and 8 prompts for AI assistants",
   "keywords": [
     "kubernetes",
     "kubectl",