kubectl-mcp-server 1.19.2 → 1.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +24 -16
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -21,7 +21,8 @@ Talk to your clusters like you talk to a DevOps expert. Debug crashed pods, opti
21
21
  <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>
22
22
  <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>
23
23
  <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>
24
- <a href="https://github.com/rohitg00/kubectl-mcp-server"><img src="https://img.shields.io/badge/tests-234%20passed-success" alt="Tests"></a>
24
+ <a href="https://github.com/rohitg00/kubectl-mcp-server"><img src="https://img.shields.io/badge/tests-234%20passed-success"
25
+ <a href="https://deepwiki.com/rohitg00/kubectl-mcp-server"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
25
26
  <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>
26
27
  </p>
27
28
 
@@ -108,7 +109,7 @@ Simply ask your AI assistant in natural language:
108
109
  - Interactive HTML dashboards with live metrics
109
110
  - Visual timeline of events and resource usage
110
111
 
111
- **224 powerful tools** | **8 workflow prompts** | **8 data resources** | **Works with all major AI assistants**
112
+ **253 powerful tools** | **8 workflow prompts** | **8 data resources** | **Works with all major AI assistants**
112
113
 
113
114
  ## Why kubectl-mcp-server?
114
115
 
@@ -178,9 +179,12 @@ pip install git+https://github.com/rohitg00/kubectl-mcp-server.git
178
179
  ### Docker
179
180
 
180
181
  ```bash
181
- # Pull and run with Docker
182
+ # Pull from Docker Hub
182
183
  docker pull rohitghumare64/kubectl-mcp-server:latest
183
184
 
185
+ # Or pull from GitHub Container Registry
186
+ docker pull ghcr.io/rohitg00/kubectl-mcp-server:latest
187
+
184
188
  # Run with stdio transport
185
189
  docker run -i -v $HOME/.kube:/root/.kube:ro rohitghumare64/kubectl-mcp-server:latest
186
190
 
@@ -422,7 +426,7 @@ Add to `~/.config/roo-code/mcp.json` or `~/.config/kilo-code/mcp.json`:
422
426
 
423
427
  ## Complete Feature Set
424
428
 
425
- ### 224 MCP Tools for Complete Kubernetes Management
429
+ ### 253 MCP Tools for Complete Kubernetes Management
426
430
 
427
431
  | Category | Tools |
428
432
  |----------|-------|
@@ -457,6 +461,8 @@ Add to `~/.config/roo-code/mcp.json` or `~/.config/kilo-code/mcp.json`:
457
461
  | **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` |
458
462
  | **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` |
459
463
  | **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` |
464
+ | **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` |
465
+ | **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` |
460
466
 
461
467
  ### MCP Resources
462
468
 
@@ -496,12 +502,12 @@ Pre-built workflow prompts for common Kubernetes operations:
496
502
 
497
503
  ### Key Capabilities
498
504
 
499
- - 🤖 **224 Powerful Tools** - Complete Kubernetes management from pods to security
505
+ - 🤖 **253 Powerful Tools** - Complete Kubernetes management from pods to security
500
506
  - 🎯 **8 AI Workflow Prompts** - Pre-built workflows for common operations
501
507
  - 📊 **8 MCP Resources** - Browsable Kubernetes data exposure
502
508
  - 🎨 **6 Interactive Dashboards** - HTML UI tools for visual cluster management
503
509
  - 🌐 **26 Browser Tools** - Web automation with cloud provider support
504
- - 🔄 **93 Ecosystem Tools** - GitOps, Cert-Manager, Policy, Backup, KEDA, Cilium, Rollouts, CAPI, KubeVirt, Istio
510
+ - 🔄 **107 Ecosystem Tools** - GitOps, Cert-Manager, Policy, Backup, KEDA, Cilium, Rollouts, CAPI, KubeVirt, Istio, vCluster
505
511
  - ⚡ **Multi-Transport** - stdio, SSE, HTTP, streamable-http
506
512
  - 🔐 **Security First** - Non-destructive mode, secret masking, RBAC validation
507
513
  - 🏥 **Advanced Diagnostics** - AI-powered troubleshooting and cost optimization
@@ -736,7 +742,7 @@ EOF
736
742
  agentgateway --config gateway.yaml
737
743
  ```
738
744
 
739
- Connect clients to `http://localhost:3000/mcp` for unified access to all 224 tools.
745
+ Connect clients to `http://localhost:3000/mcp` for unified access to all 253 tools.
740
746
 
741
747
  ## In-Cluster Deployment
742
748
 
@@ -795,7 +801,7 @@ kubectl apply -f deploy/kagent/toolserver-stdio.yaml
795
801
  kagent dashboard
796
802
  ```
797
803
 
798
- Your AI agents now have access to all 224 Kubernetes tools. See [kagent quickstart](https://kagent.dev/docs/kagent/getting-started/quickstart).
804
+ Your AI agents now have access to all 253 Kubernetes tools. See [kagent quickstart](https://kagent.dev/docs/kagent/getting-started/quickstart).
799
805
 
800
806
  ## Architecture
801
807
 
@@ -813,7 +819,7 @@ The MCP server implements the [Model Context Protocol](https://github.com/modelc
813
819
  ```
814
820
  kubectl_mcp_tool/
815
821
  ├── mcp_server.py # Main server (FastMCP, transports)
816
- ├── tools/ # 224 MCP tools organized by category
822
+ ├── tools/ # 253 MCP tools organized by category
817
823
  │ ├── pods.py # Pod management & diagnostics
818
824
  │ ├── deployments.py # Deployments, StatefulSets, DaemonSets
819
825
  │ ├── core.py # Namespaces, ConfigMaps, Secrets
@@ -835,15 +841,16 @@ kubectl_mcp_tool/
835
841
  │ ├── rollouts.py # Argo Rollouts/Flagger
836
842
  │ ├── capi.py # Cluster API
837
843
  │ ├── kubevirt.py # KubeVirt VMs
838
- │ └── kiali.py # Istio/Kiali service mesh
844
+ │ ├── kiali.py # Istio/Kiali service mesh
845
+ │ └── vind.py # vCluster (virtual clusters)
839
846
  ├── resources/ # 8 MCP Resources for data exposure
840
847
  ├── prompts/ # 8 MCP Prompts for workflows
841
848
  └── cli/ # CLI interface
842
849
  ```
843
850
 
844
- ## Agent Skills (24 Skills for AI Coding Agents)
851
+ ## Agent Skills (25 Skills for AI Coding Agents)
845
852
 
846
- 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.
853
+ 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.
847
854
 
848
855
  ### Quick Install
849
856
 
@@ -855,7 +862,7 @@ cp -r kubernetes-skills/claude/* ~/.claude/skills/
855
862
  cp -r kubernetes-skills/claude/k8s-helm ~/.claude/skills/
856
863
  ```
857
864
 
858
- ### Available Skills (24)
865
+ ### Available Skills (25)
859
866
 
860
867
  | Category | Skills |
861
868
  |----------|--------|
@@ -865,7 +872,7 @@ cp -r kubernetes-skills/claude/k8s-helm ~/.claude/skills/
865
872
  | **Security** | k8s-security, k8s-policy, k8s-certs |
866
873
  | **GitOps** | k8s-gitops, k8s-rollouts |
867
874
  | **Scaling** | k8s-autoscaling, k8s-cost, k8s-backup |
868
- | **Multi-Cluster** | k8s-multicluster, k8s-capi, k8s-kubevirt |
875
+ | **Multi-Cluster** | k8s-multicluster, k8s-capi, k8s-kubevirt, k8s-vind |
869
876
  | **Networking** | k8s-service-mesh, k8s-cilium |
870
877
  | **Tools** | k8s-browser, k8s-cli |
871
878
 
@@ -893,7 +900,8 @@ Seamlessly manage multiple Kubernetes clusters through natural language. **Every
893
900
 
894
901
  ### Context Parameter (v1.15.0)
895
902
 
896
- All 224 tools accept an optional `context` parameter to target specific clusters:
903
+ Most kubectl-backed tools accept an optional `context` parameter to target specific clusters.
904
+ Note: vCluster (vind) and kind tools run via their local CLIs and do not accept the `context` parameter.
897
905
 
898
906
  **Talk to your AI assistant:**
899
907
  ```
@@ -982,7 +990,7 @@ pytest tests/ -v -m unit
982
990
  tests/
983
991
  ├── __init__.py # Test package
984
992
  ├── conftest.py # Shared fixtures and mocks
985
- ├── test_tools.py # Unit tests for 224 MCP tools
993
+ ├── test_tools.py # Unit tests for 253 MCP tools
986
994
  ├── test_resources.py # Tests for 8 MCP Resources
987
995
  ├── test_prompts.py # Tests for 8 MCP Prompts
988
996
  └── test_server.py # Server initialization tests
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "kubectl-mcp-server",
3
- "version": "1.19.2",
4
- "description": "A Model Context Protocol (MCP) server for Kubernetes with 235+ tools, 8 resources, and 8 prompts for AI assistants",
3
+ "version": "1.21.0",
4
+ "description": "A Model Context Protocol (MCP) server for Kubernetes with 270+ tools, 8 resources, and 8 prompts for AI assistants",
5
5
  "keywords": [
6
6
  "kubernetes",
7
7
  "kubectl",