kubectl-mcp-server 1.19.3__tar.gz → 1.22.0__tar.gz
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.
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/PKG-INFO +74 -18
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/README.md +72 -16
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_server.egg-info/PKG-INFO +74 -18
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_server.egg-info/SOURCES.txt +5 -1
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/__init__.py +1 -1
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/mcp_server.py +5 -1
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/__init__.py +4 -0
- kubectl_mcp_server-1.22.0/kubectl_mcp_tool/tools/kind.py +1723 -0
- kubectl_mcp_server-1.22.0/kubectl_mcp_tool/tools/vind.py +744 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/setup.py +2 -2
- kubectl_mcp_server-1.22.0/tests/test_kind.py +1206 -0
- kubectl_mcp_server-1.22.0/tests/test_vind.py +512 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/LICENSE +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_server.egg-info/dependency_links.txt +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_server.egg-info/entry_points.txt +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_server.egg-info/requires.txt +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_server.egg-info/top_level.txt +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/__main__.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/auth/__init__.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/auth/config.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/auth/scopes.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/auth/verifier.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/cli/__init__.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/cli/__main__.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/cli/cli.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/cli/errors.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/cli/output.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/config/__init__.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/config/loader.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/config/schema.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/crd_detector.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/diagnostics.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/k8s_config.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/observability/__init__.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/observability/metrics.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/observability/stats.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/observability/tracing.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/prompts/__init__.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/prompts/builtin.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/prompts/custom.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/prompts/prompts.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/providers.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/resources/__init__.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/resources/resources.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/safety.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/backup.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/browser.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/capi.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/certs.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/cilium.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/cluster.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/core.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/cost.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/deployments.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/diagnostics.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/gitops.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/helm.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/keda.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/kiali.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/kubevirt.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/networking.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/operations.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/pods.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/policy.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/rollouts.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/security.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/storage.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/ui.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/tools/utils.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/utils/__init__.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_tool/utils/helpers.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/setup.cfg +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/tests/__init__.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/tests/conftest.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/tests/test_auth.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/tests/test_browser.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/tests/test_cli.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/tests/test_config.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/tests/test_ecosystem.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/tests/test_mcp_integration.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/tests/test_observability.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/tests/test_prompts.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/tests/test_resources.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/tests/test_safety.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/tests/test_server.py +0 -0
- {kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/tests/test_tools.py +0 -0
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: kubectl-mcp-server
|
|
3
|
-
Version: 1.
|
|
4
|
-
Summary: A Model Context Protocol (MCP) server for Kubernetes with
|
|
3
|
+
Version: 1.22.0
|
|
4
|
+
Summary: A Model Context Protocol (MCP) server for Kubernetes with 270+ tools, 8 resources, and 8 prompts
|
|
5
5
|
Home-page: https://github.com/rohitg00/kubectl-mcp-server
|
|
6
6
|
Author: Rohit Ghumare
|
|
7
7
|
Author-email: ghumare64@gmail.com
|
|
@@ -79,7 +79,8 @@ Talk to your clusters like you talk to a DevOps expert. Debug crashed pods, opti
|
|
|
79
79
|
<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>
|
|
80
80
|
<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>
|
|
81
81
|
<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>
|
|
82
|
-
<a href="https://github.com/rohitg00/kubectl-mcp-server"><img src="https://img.shields.io/badge/tests-234%20passed-success"
|
|
82
|
+
<a href="https://github.com/rohitg00/kubectl-mcp-server"><img src="https://img.shields.io/badge/tests-234%20passed-success"
|
|
83
|
+
<a href="https://deepwiki.com/rohitg00/kubectl-mcp-server"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
|
|
83
84
|
<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>
|
|
84
85
|
</p>
|
|
85
86
|
|
|
@@ -166,7 +167,7 @@ Simply ask your AI assistant in natural language:
|
|
|
166
167
|
- Interactive HTML dashboards with live metrics
|
|
167
168
|
- Visual timeline of events and resource usage
|
|
168
169
|
|
|
169
|
-
**
|
|
170
|
+
**253 powerful tools** | **8 workflow prompts** | **8 data resources** | **Works with all major AI assistants**
|
|
170
171
|
|
|
171
172
|
## Why kubectl-mcp-server?
|
|
172
173
|
|
|
@@ -236,9 +237,12 @@ pip install git+https://github.com/rohitg00/kubectl-mcp-server.git
|
|
|
236
237
|
### Docker
|
|
237
238
|
|
|
238
239
|
```bash
|
|
239
|
-
# Pull
|
|
240
|
+
# Pull from Docker Hub
|
|
240
241
|
docker pull rohitghumare64/kubectl-mcp-server:latest
|
|
241
242
|
|
|
243
|
+
# Or pull from GitHub Container Registry
|
|
244
|
+
docker pull ghcr.io/rohitg00/kubectl-mcp-server:latest
|
|
245
|
+
|
|
242
246
|
# Run with stdio transport
|
|
243
247
|
docker run -i -v $HOME/.kube:/root/.kube:ro rohitghumare64/kubectl-mcp-server:latest
|
|
244
248
|
|
|
@@ -480,7 +484,7 @@ Add to `~/.config/roo-code/mcp.json` or `~/.config/kilo-code/mcp.json`:
|
|
|
480
484
|
|
|
481
485
|
## Complete Feature Set
|
|
482
486
|
|
|
483
|
-
###
|
|
487
|
+
### 253 MCP Tools for Complete Kubernetes Management
|
|
484
488
|
|
|
485
489
|
| Category | Tools |
|
|
486
490
|
|----------|-------|
|
|
@@ -515,6 +519,8 @@ Add to `~/.config/roo-code/mcp.json` or `~/.config/kilo-code/mcp.json`:
|
|
|
515
519
|
| **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` |
|
|
516
520
|
| **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` |
|
|
517
521
|
| **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` |
|
|
522
|
+
| **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` |
|
|
523
|
+
| **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` |
|
|
518
524
|
|
|
519
525
|
### MCP Resources
|
|
520
526
|
|
|
@@ -554,12 +560,12 @@ Pre-built workflow prompts for common Kubernetes operations:
|
|
|
554
560
|
|
|
555
561
|
### Key Capabilities
|
|
556
562
|
|
|
557
|
-
- 🤖 **
|
|
563
|
+
- 🤖 **253 Powerful Tools** - Complete Kubernetes management from pods to security
|
|
558
564
|
- 🎯 **8 AI Workflow Prompts** - Pre-built workflows for common operations
|
|
559
565
|
- 📊 **8 MCP Resources** - Browsable Kubernetes data exposure
|
|
560
566
|
- 🎨 **6 Interactive Dashboards** - HTML UI tools for visual cluster management
|
|
561
567
|
- 🌐 **26 Browser Tools** - Web automation with cloud provider support
|
|
562
|
-
- 🔄 **
|
|
568
|
+
- 🔄 **107 Ecosystem Tools** - GitOps, Cert-Manager, Policy, Backup, KEDA, Cilium, Rollouts, CAPI, KubeVirt, Istio, vCluster
|
|
563
569
|
- ⚡ **Multi-Transport** - stdio, SSE, HTTP, streamable-http
|
|
564
570
|
- 🔐 **Security First** - Non-destructive mode, secret masking, RBAC validation
|
|
565
571
|
- 🏥 **Advanced Diagnostics** - AI-powered troubleshooting and cost optimization
|
|
@@ -726,6 +732,54 @@ kubectl-mcp-server
|
|
|
726
732
|
- Remote CDP connections
|
|
727
733
|
- Session management
|
|
728
734
|
|
|
735
|
+
## Optional: kubectl-mcp-app (8 Interactive UI Dashboards)
|
|
736
|
+
|
|
737
|
+
A standalone npm package that provides beautiful, interactive UI dashboards for Kubernetes management using the MCP ext-apps SDK.
|
|
738
|
+
|
|
739
|
+
**Installation:**
|
|
740
|
+
|
|
741
|
+
```bash
|
|
742
|
+
# Via npm
|
|
743
|
+
npm install -g kubectl-mcp-app
|
|
744
|
+
|
|
745
|
+
# Or via npx (no install)
|
|
746
|
+
npx kubectl-mcp-app
|
|
747
|
+
```
|
|
748
|
+
|
|
749
|
+
**Claude Desktop Configuration:**
|
|
750
|
+
|
|
751
|
+
```json
|
|
752
|
+
{
|
|
753
|
+
"mcpServers": {
|
|
754
|
+
"kubectl-app": {
|
|
755
|
+
"command": "npx",
|
|
756
|
+
"args": ["kubectl-mcp-app"]
|
|
757
|
+
}
|
|
758
|
+
}
|
|
759
|
+
}
|
|
760
|
+
```
|
|
761
|
+
|
|
762
|
+
**8 Interactive UI Tools:**
|
|
763
|
+
|
|
764
|
+
| Tool | Description |
|
|
765
|
+
| ---- | ----------- |
|
|
766
|
+
| `k8s-pods` | Interactive pod viewer with filtering, sorting, status indicators |
|
|
767
|
+
| `k8s-logs` | Real-time log viewer with syntax highlighting and search |
|
|
768
|
+
| `k8s-deploy` | Deployment dashboard with rollout status, scaling, rollback |
|
|
769
|
+
| `k8s-helm` | Helm release manager with upgrade/rollback actions |
|
|
770
|
+
| `k8s-cluster` | Cluster overview with node health and resource metrics |
|
|
771
|
+
| `k8s-cost` | Cost analyzer with waste detection and recommendations |
|
|
772
|
+
| `k8s-events` | Events timeline with type filtering and grouping |
|
|
773
|
+
| `k8s-network` | Network topology graph showing Services/Pods/Ingress |
|
|
774
|
+
|
|
775
|
+
**Features:**
|
|
776
|
+
- 🎨 Dark/light theme support
|
|
777
|
+
- 📊 Real-time data visualization
|
|
778
|
+
- 🖱️ Interactive actions (scale, restart, delete)
|
|
779
|
+
- 🔗 Seamless integration with kubectl-mcp-server
|
|
780
|
+
|
|
781
|
+
**More Info**: See [kubectl-mcp-app/README.md](./kubectl-mcp-app/README.md) for full documentation.
|
|
782
|
+
|
|
729
783
|
## Enterprise: OAuth 2.1 Authentication
|
|
730
784
|
|
|
731
785
|
Secure your MCP server with OAuth 2.1 authentication (RFC 9728).
|
|
@@ -794,7 +848,7 @@ EOF
|
|
|
794
848
|
agentgateway --config gateway.yaml
|
|
795
849
|
```
|
|
796
850
|
|
|
797
|
-
Connect clients to `http://localhost:3000/mcp` for unified access to all
|
|
851
|
+
Connect clients to `http://localhost:3000/mcp` for unified access to all 253 tools.
|
|
798
852
|
|
|
799
853
|
## In-Cluster Deployment
|
|
800
854
|
|
|
@@ -853,7 +907,7 @@ kubectl apply -f deploy/kagent/toolserver-stdio.yaml
|
|
|
853
907
|
kagent dashboard
|
|
854
908
|
```
|
|
855
909
|
|
|
856
|
-
Your AI agents now have access to all
|
|
910
|
+
Your AI agents now have access to all 253 Kubernetes tools. See [kagent quickstart](https://kagent.dev/docs/kagent/getting-started/quickstart).
|
|
857
911
|
|
|
858
912
|
## Architecture
|
|
859
913
|
|
|
@@ -871,7 +925,7 @@ The MCP server implements the [Model Context Protocol](https://github.com/modelc
|
|
|
871
925
|
```
|
|
872
926
|
kubectl_mcp_tool/
|
|
873
927
|
├── mcp_server.py # Main server (FastMCP, transports)
|
|
874
|
-
├── tools/ #
|
|
928
|
+
├── tools/ # 253 MCP tools organized by category
|
|
875
929
|
│ ├── pods.py # Pod management & diagnostics
|
|
876
930
|
│ ├── deployments.py # Deployments, StatefulSets, DaemonSets
|
|
877
931
|
│ ├── core.py # Namespaces, ConfigMaps, Secrets
|
|
@@ -893,15 +947,16 @@ kubectl_mcp_tool/
|
|
|
893
947
|
│ ├── rollouts.py # Argo Rollouts/Flagger
|
|
894
948
|
│ ├── capi.py # Cluster API
|
|
895
949
|
│ ├── kubevirt.py # KubeVirt VMs
|
|
896
|
-
│
|
|
950
|
+
│ ├── kiali.py # Istio/Kiali service mesh
|
|
951
|
+
│ └── vind.py # vCluster (virtual clusters)
|
|
897
952
|
├── resources/ # 8 MCP Resources for data exposure
|
|
898
953
|
├── prompts/ # 8 MCP Prompts for workflows
|
|
899
954
|
└── cli/ # CLI interface
|
|
900
955
|
```
|
|
901
956
|
|
|
902
|
-
## Agent Skills (
|
|
957
|
+
## Agent Skills (25 Skills for AI Coding Agents)
|
|
903
958
|
|
|
904
|
-
Extend your AI coding agent with Kubernetes expertise using our [Agent Skills](https://
|
|
959
|
+
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.
|
|
905
960
|
|
|
906
961
|
### Quick Install
|
|
907
962
|
|
|
@@ -913,7 +968,7 @@ cp -r kubernetes-skills/claude/* ~/.claude/skills/
|
|
|
913
968
|
cp -r kubernetes-skills/claude/k8s-helm ~/.claude/skills/
|
|
914
969
|
```
|
|
915
970
|
|
|
916
|
-
### Available Skills (
|
|
971
|
+
### Available Skills (25)
|
|
917
972
|
|
|
918
973
|
| Category | Skills |
|
|
919
974
|
|----------|--------|
|
|
@@ -923,7 +978,7 @@ cp -r kubernetes-skills/claude/k8s-helm ~/.claude/skills/
|
|
|
923
978
|
| **Security** | k8s-security, k8s-policy, k8s-certs |
|
|
924
979
|
| **GitOps** | k8s-gitops, k8s-rollouts |
|
|
925
980
|
| **Scaling** | k8s-autoscaling, k8s-cost, k8s-backup |
|
|
926
|
-
| **Multi-Cluster** | k8s-multicluster, k8s-capi, k8s-kubevirt |
|
|
981
|
+
| **Multi-Cluster** | k8s-multicluster, k8s-capi, k8s-kubevirt, k8s-vind |
|
|
927
982
|
| **Networking** | k8s-service-mesh, k8s-cilium |
|
|
928
983
|
| **Tools** | k8s-browser, k8s-cli |
|
|
929
984
|
|
|
@@ -951,7 +1006,8 @@ Seamlessly manage multiple Kubernetes clusters through natural language. **Every
|
|
|
951
1006
|
|
|
952
1007
|
### Context Parameter (v1.15.0)
|
|
953
1008
|
|
|
954
|
-
|
|
1009
|
+
Most kubectl-backed tools accept an optional `context` parameter to target specific clusters.
|
|
1010
|
+
Note: vCluster (vind) and kind tools run via their local CLIs and do not accept the `context` parameter.
|
|
955
1011
|
|
|
956
1012
|
**Talk to your AI assistant:**
|
|
957
1013
|
```
|
|
@@ -1040,7 +1096,7 @@ pytest tests/ -v -m unit
|
|
|
1040
1096
|
tests/
|
|
1041
1097
|
├── __init__.py # Test package
|
|
1042
1098
|
├── conftest.py # Shared fixtures and mocks
|
|
1043
|
-
├── test_tools.py # Unit tests for
|
|
1099
|
+
├── test_tools.py # Unit tests for 253 MCP tools
|
|
1044
1100
|
├── test_resources.py # Tests for 8 MCP Resources
|
|
1045
1101
|
├── test_prompts.py # Tests for 8 MCP Prompts
|
|
1046
1102
|
└── test_server.py # Server initialization tests
|
|
@@ -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"
|
|
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
|
-
**
|
|
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
|
|
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
|
-
###
|
|
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
|
-
- 🤖 **
|
|
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
|
-
- 🔄 **
|
|
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
|
|
@@ -668,6 +674,54 @@ kubectl-mcp-server
|
|
|
668
674
|
- Remote CDP connections
|
|
669
675
|
- Session management
|
|
670
676
|
|
|
677
|
+
## Optional: kubectl-mcp-app (8 Interactive UI Dashboards)
|
|
678
|
+
|
|
679
|
+
A standalone npm package that provides beautiful, interactive UI dashboards for Kubernetes management using the MCP ext-apps SDK.
|
|
680
|
+
|
|
681
|
+
**Installation:**
|
|
682
|
+
|
|
683
|
+
```bash
|
|
684
|
+
# Via npm
|
|
685
|
+
npm install -g kubectl-mcp-app
|
|
686
|
+
|
|
687
|
+
# Or via npx (no install)
|
|
688
|
+
npx kubectl-mcp-app
|
|
689
|
+
```
|
|
690
|
+
|
|
691
|
+
**Claude Desktop Configuration:**
|
|
692
|
+
|
|
693
|
+
```json
|
|
694
|
+
{
|
|
695
|
+
"mcpServers": {
|
|
696
|
+
"kubectl-app": {
|
|
697
|
+
"command": "npx",
|
|
698
|
+
"args": ["kubectl-mcp-app"]
|
|
699
|
+
}
|
|
700
|
+
}
|
|
701
|
+
}
|
|
702
|
+
```
|
|
703
|
+
|
|
704
|
+
**8 Interactive UI Tools:**
|
|
705
|
+
|
|
706
|
+
| Tool | Description |
|
|
707
|
+
| ---- | ----------- |
|
|
708
|
+
| `k8s-pods` | Interactive pod viewer with filtering, sorting, status indicators |
|
|
709
|
+
| `k8s-logs` | Real-time log viewer with syntax highlighting and search |
|
|
710
|
+
| `k8s-deploy` | Deployment dashboard with rollout status, scaling, rollback |
|
|
711
|
+
| `k8s-helm` | Helm release manager with upgrade/rollback actions |
|
|
712
|
+
| `k8s-cluster` | Cluster overview with node health and resource metrics |
|
|
713
|
+
| `k8s-cost` | Cost analyzer with waste detection and recommendations |
|
|
714
|
+
| `k8s-events` | Events timeline with type filtering and grouping |
|
|
715
|
+
| `k8s-network` | Network topology graph showing Services/Pods/Ingress |
|
|
716
|
+
|
|
717
|
+
**Features:**
|
|
718
|
+
- 🎨 Dark/light theme support
|
|
719
|
+
- 📊 Real-time data visualization
|
|
720
|
+
- 🖱️ Interactive actions (scale, restart, delete)
|
|
721
|
+
- 🔗 Seamless integration with kubectl-mcp-server
|
|
722
|
+
|
|
723
|
+
**More Info**: See [kubectl-mcp-app/README.md](./kubectl-mcp-app/README.md) for full documentation.
|
|
724
|
+
|
|
671
725
|
## Enterprise: OAuth 2.1 Authentication
|
|
672
726
|
|
|
673
727
|
Secure your MCP server with OAuth 2.1 authentication (RFC 9728).
|
|
@@ -736,7 +790,7 @@ EOF
|
|
|
736
790
|
agentgateway --config gateway.yaml
|
|
737
791
|
```
|
|
738
792
|
|
|
739
|
-
Connect clients to `http://localhost:3000/mcp` for unified access to all
|
|
793
|
+
Connect clients to `http://localhost:3000/mcp` for unified access to all 253 tools.
|
|
740
794
|
|
|
741
795
|
## In-Cluster Deployment
|
|
742
796
|
|
|
@@ -795,7 +849,7 @@ kubectl apply -f deploy/kagent/toolserver-stdio.yaml
|
|
|
795
849
|
kagent dashboard
|
|
796
850
|
```
|
|
797
851
|
|
|
798
|
-
Your AI agents now have access to all
|
|
852
|
+
Your AI agents now have access to all 253 Kubernetes tools. See [kagent quickstart](https://kagent.dev/docs/kagent/getting-started/quickstart).
|
|
799
853
|
|
|
800
854
|
## Architecture
|
|
801
855
|
|
|
@@ -813,7 +867,7 @@ The MCP server implements the [Model Context Protocol](https://github.com/modelc
|
|
|
813
867
|
```
|
|
814
868
|
kubectl_mcp_tool/
|
|
815
869
|
├── mcp_server.py # Main server (FastMCP, transports)
|
|
816
|
-
├── tools/ #
|
|
870
|
+
├── tools/ # 253 MCP tools organized by category
|
|
817
871
|
│ ├── pods.py # Pod management & diagnostics
|
|
818
872
|
│ ├── deployments.py # Deployments, StatefulSets, DaemonSets
|
|
819
873
|
│ ├── core.py # Namespaces, ConfigMaps, Secrets
|
|
@@ -835,15 +889,16 @@ kubectl_mcp_tool/
|
|
|
835
889
|
│ ├── rollouts.py # Argo Rollouts/Flagger
|
|
836
890
|
│ ├── capi.py # Cluster API
|
|
837
891
|
│ ├── kubevirt.py # KubeVirt VMs
|
|
838
|
-
│
|
|
892
|
+
│ ├── kiali.py # Istio/Kiali service mesh
|
|
893
|
+
│ └── vind.py # vCluster (virtual clusters)
|
|
839
894
|
├── resources/ # 8 MCP Resources for data exposure
|
|
840
895
|
├── prompts/ # 8 MCP Prompts for workflows
|
|
841
896
|
└── cli/ # CLI interface
|
|
842
897
|
```
|
|
843
898
|
|
|
844
|
-
## Agent Skills (
|
|
899
|
+
## Agent Skills (25 Skills for AI Coding Agents)
|
|
845
900
|
|
|
846
|
-
Extend your AI coding agent with Kubernetes expertise using our [Agent Skills](https://
|
|
901
|
+
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
902
|
|
|
848
903
|
### Quick Install
|
|
849
904
|
|
|
@@ -855,7 +910,7 @@ cp -r kubernetes-skills/claude/* ~/.claude/skills/
|
|
|
855
910
|
cp -r kubernetes-skills/claude/k8s-helm ~/.claude/skills/
|
|
856
911
|
```
|
|
857
912
|
|
|
858
|
-
### Available Skills (
|
|
913
|
+
### Available Skills (25)
|
|
859
914
|
|
|
860
915
|
| Category | Skills |
|
|
861
916
|
|----------|--------|
|
|
@@ -865,7 +920,7 @@ cp -r kubernetes-skills/claude/k8s-helm ~/.claude/skills/
|
|
|
865
920
|
| **Security** | k8s-security, k8s-policy, k8s-certs |
|
|
866
921
|
| **GitOps** | k8s-gitops, k8s-rollouts |
|
|
867
922
|
| **Scaling** | k8s-autoscaling, k8s-cost, k8s-backup |
|
|
868
|
-
| **Multi-Cluster** | k8s-multicluster, k8s-capi, k8s-kubevirt |
|
|
923
|
+
| **Multi-Cluster** | k8s-multicluster, k8s-capi, k8s-kubevirt, k8s-vind |
|
|
869
924
|
| **Networking** | k8s-service-mesh, k8s-cilium |
|
|
870
925
|
| **Tools** | k8s-browser, k8s-cli |
|
|
871
926
|
|
|
@@ -893,7 +948,8 @@ Seamlessly manage multiple Kubernetes clusters through natural language. **Every
|
|
|
893
948
|
|
|
894
949
|
### Context Parameter (v1.15.0)
|
|
895
950
|
|
|
896
|
-
|
|
951
|
+
Most kubectl-backed tools accept an optional `context` parameter to target specific clusters.
|
|
952
|
+
Note: vCluster (vind) and kind tools run via their local CLIs and do not accept the `context` parameter.
|
|
897
953
|
|
|
898
954
|
**Talk to your AI assistant:**
|
|
899
955
|
```
|
|
@@ -982,7 +1038,7 @@ pytest tests/ -v -m unit
|
|
|
982
1038
|
tests/
|
|
983
1039
|
├── __init__.py # Test package
|
|
984
1040
|
├── conftest.py # Shared fixtures and mocks
|
|
985
|
-
├── test_tools.py # Unit tests for
|
|
1041
|
+
├── test_tools.py # Unit tests for 253 MCP tools
|
|
986
1042
|
├── test_resources.py # Tests for 8 MCP Resources
|
|
987
1043
|
├── test_prompts.py # Tests for 8 MCP Prompts
|
|
988
1044
|
└── test_server.py # Server initialization tests
|
{kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_server.egg-info/PKG-INFO
RENAMED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: kubectl-mcp-server
|
|
3
|
-
Version: 1.
|
|
4
|
-
Summary: A Model Context Protocol (MCP) server for Kubernetes with
|
|
3
|
+
Version: 1.22.0
|
|
4
|
+
Summary: A Model Context Protocol (MCP) server for Kubernetes with 270+ tools, 8 resources, and 8 prompts
|
|
5
5
|
Home-page: https://github.com/rohitg00/kubectl-mcp-server
|
|
6
6
|
Author: Rohit Ghumare
|
|
7
7
|
Author-email: ghumare64@gmail.com
|
|
@@ -79,7 +79,8 @@ Talk to your clusters like you talk to a DevOps expert. Debug crashed pods, opti
|
|
|
79
79
|
<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>
|
|
80
80
|
<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>
|
|
81
81
|
<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>
|
|
82
|
-
<a href="https://github.com/rohitg00/kubectl-mcp-server"><img src="https://img.shields.io/badge/tests-234%20passed-success"
|
|
82
|
+
<a href="https://github.com/rohitg00/kubectl-mcp-server"><img src="https://img.shields.io/badge/tests-234%20passed-success"
|
|
83
|
+
<a href="https://deepwiki.com/rohitg00/kubectl-mcp-server"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
|
|
83
84
|
<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>
|
|
84
85
|
</p>
|
|
85
86
|
|
|
@@ -166,7 +167,7 @@ Simply ask your AI assistant in natural language:
|
|
|
166
167
|
- Interactive HTML dashboards with live metrics
|
|
167
168
|
- Visual timeline of events and resource usage
|
|
168
169
|
|
|
169
|
-
**
|
|
170
|
+
**253 powerful tools** | **8 workflow prompts** | **8 data resources** | **Works with all major AI assistants**
|
|
170
171
|
|
|
171
172
|
## Why kubectl-mcp-server?
|
|
172
173
|
|
|
@@ -236,9 +237,12 @@ pip install git+https://github.com/rohitg00/kubectl-mcp-server.git
|
|
|
236
237
|
### Docker
|
|
237
238
|
|
|
238
239
|
```bash
|
|
239
|
-
# Pull
|
|
240
|
+
# Pull from Docker Hub
|
|
240
241
|
docker pull rohitghumare64/kubectl-mcp-server:latest
|
|
241
242
|
|
|
243
|
+
# Or pull from GitHub Container Registry
|
|
244
|
+
docker pull ghcr.io/rohitg00/kubectl-mcp-server:latest
|
|
245
|
+
|
|
242
246
|
# Run with stdio transport
|
|
243
247
|
docker run -i -v $HOME/.kube:/root/.kube:ro rohitghumare64/kubectl-mcp-server:latest
|
|
244
248
|
|
|
@@ -480,7 +484,7 @@ Add to `~/.config/roo-code/mcp.json` or `~/.config/kilo-code/mcp.json`:
|
|
|
480
484
|
|
|
481
485
|
## Complete Feature Set
|
|
482
486
|
|
|
483
|
-
###
|
|
487
|
+
### 253 MCP Tools for Complete Kubernetes Management
|
|
484
488
|
|
|
485
489
|
| Category | Tools |
|
|
486
490
|
|----------|-------|
|
|
@@ -515,6 +519,8 @@ Add to `~/.config/roo-code/mcp.json` or `~/.config/kilo-code/mcp.json`:
|
|
|
515
519
|
| **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` |
|
|
516
520
|
| **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` |
|
|
517
521
|
| **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` |
|
|
522
|
+
| **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` |
|
|
523
|
+
| **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` |
|
|
518
524
|
|
|
519
525
|
### MCP Resources
|
|
520
526
|
|
|
@@ -554,12 +560,12 @@ Pre-built workflow prompts for common Kubernetes operations:
|
|
|
554
560
|
|
|
555
561
|
### Key Capabilities
|
|
556
562
|
|
|
557
|
-
- 🤖 **
|
|
563
|
+
- 🤖 **253 Powerful Tools** - Complete Kubernetes management from pods to security
|
|
558
564
|
- 🎯 **8 AI Workflow Prompts** - Pre-built workflows for common operations
|
|
559
565
|
- 📊 **8 MCP Resources** - Browsable Kubernetes data exposure
|
|
560
566
|
- 🎨 **6 Interactive Dashboards** - HTML UI tools for visual cluster management
|
|
561
567
|
- 🌐 **26 Browser Tools** - Web automation with cloud provider support
|
|
562
|
-
- 🔄 **
|
|
568
|
+
- 🔄 **107 Ecosystem Tools** - GitOps, Cert-Manager, Policy, Backup, KEDA, Cilium, Rollouts, CAPI, KubeVirt, Istio, vCluster
|
|
563
569
|
- ⚡ **Multi-Transport** - stdio, SSE, HTTP, streamable-http
|
|
564
570
|
- 🔐 **Security First** - Non-destructive mode, secret masking, RBAC validation
|
|
565
571
|
- 🏥 **Advanced Diagnostics** - AI-powered troubleshooting and cost optimization
|
|
@@ -726,6 +732,54 @@ kubectl-mcp-server
|
|
|
726
732
|
- Remote CDP connections
|
|
727
733
|
- Session management
|
|
728
734
|
|
|
735
|
+
## Optional: kubectl-mcp-app (8 Interactive UI Dashboards)
|
|
736
|
+
|
|
737
|
+
A standalone npm package that provides beautiful, interactive UI dashboards for Kubernetes management using the MCP ext-apps SDK.
|
|
738
|
+
|
|
739
|
+
**Installation:**
|
|
740
|
+
|
|
741
|
+
```bash
|
|
742
|
+
# Via npm
|
|
743
|
+
npm install -g kubectl-mcp-app
|
|
744
|
+
|
|
745
|
+
# Or via npx (no install)
|
|
746
|
+
npx kubectl-mcp-app
|
|
747
|
+
```
|
|
748
|
+
|
|
749
|
+
**Claude Desktop Configuration:**
|
|
750
|
+
|
|
751
|
+
```json
|
|
752
|
+
{
|
|
753
|
+
"mcpServers": {
|
|
754
|
+
"kubectl-app": {
|
|
755
|
+
"command": "npx",
|
|
756
|
+
"args": ["kubectl-mcp-app"]
|
|
757
|
+
}
|
|
758
|
+
}
|
|
759
|
+
}
|
|
760
|
+
```
|
|
761
|
+
|
|
762
|
+
**8 Interactive UI Tools:**
|
|
763
|
+
|
|
764
|
+
| Tool | Description |
|
|
765
|
+
| ---- | ----------- |
|
|
766
|
+
| `k8s-pods` | Interactive pod viewer with filtering, sorting, status indicators |
|
|
767
|
+
| `k8s-logs` | Real-time log viewer with syntax highlighting and search |
|
|
768
|
+
| `k8s-deploy` | Deployment dashboard with rollout status, scaling, rollback |
|
|
769
|
+
| `k8s-helm` | Helm release manager with upgrade/rollback actions |
|
|
770
|
+
| `k8s-cluster` | Cluster overview with node health and resource metrics |
|
|
771
|
+
| `k8s-cost` | Cost analyzer with waste detection and recommendations |
|
|
772
|
+
| `k8s-events` | Events timeline with type filtering and grouping |
|
|
773
|
+
| `k8s-network` | Network topology graph showing Services/Pods/Ingress |
|
|
774
|
+
|
|
775
|
+
**Features:**
|
|
776
|
+
- 🎨 Dark/light theme support
|
|
777
|
+
- 📊 Real-time data visualization
|
|
778
|
+
- 🖱️ Interactive actions (scale, restart, delete)
|
|
779
|
+
- 🔗 Seamless integration with kubectl-mcp-server
|
|
780
|
+
|
|
781
|
+
**More Info**: See [kubectl-mcp-app/README.md](./kubectl-mcp-app/README.md) for full documentation.
|
|
782
|
+
|
|
729
783
|
## Enterprise: OAuth 2.1 Authentication
|
|
730
784
|
|
|
731
785
|
Secure your MCP server with OAuth 2.1 authentication (RFC 9728).
|
|
@@ -794,7 +848,7 @@ EOF
|
|
|
794
848
|
agentgateway --config gateway.yaml
|
|
795
849
|
```
|
|
796
850
|
|
|
797
|
-
Connect clients to `http://localhost:3000/mcp` for unified access to all
|
|
851
|
+
Connect clients to `http://localhost:3000/mcp` for unified access to all 253 tools.
|
|
798
852
|
|
|
799
853
|
## In-Cluster Deployment
|
|
800
854
|
|
|
@@ -853,7 +907,7 @@ kubectl apply -f deploy/kagent/toolserver-stdio.yaml
|
|
|
853
907
|
kagent dashboard
|
|
854
908
|
```
|
|
855
909
|
|
|
856
|
-
Your AI agents now have access to all
|
|
910
|
+
Your AI agents now have access to all 253 Kubernetes tools. See [kagent quickstart](https://kagent.dev/docs/kagent/getting-started/quickstart).
|
|
857
911
|
|
|
858
912
|
## Architecture
|
|
859
913
|
|
|
@@ -871,7 +925,7 @@ The MCP server implements the [Model Context Protocol](https://github.com/modelc
|
|
|
871
925
|
```
|
|
872
926
|
kubectl_mcp_tool/
|
|
873
927
|
├── mcp_server.py # Main server (FastMCP, transports)
|
|
874
|
-
├── tools/ #
|
|
928
|
+
├── tools/ # 253 MCP tools organized by category
|
|
875
929
|
│ ├── pods.py # Pod management & diagnostics
|
|
876
930
|
│ ├── deployments.py # Deployments, StatefulSets, DaemonSets
|
|
877
931
|
│ ├── core.py # Namespaces, ConfigMaps, Secrets
|
|
@@ -893,15 +947,16 @@ kubectl_mcp_tool/
|
|
|
893
947
|
│ ├── rollouts.py # Argo Rollouts/Flagger
|
|
894
948
|
│ ├── capi.py # Cluster API
|
|
895
949
|
│ ├── kubevirt.py # KubeVirt VMs
|
|
896
|
-
│
|
|
950
|
+
│ ├── kiali.py # Istio/Kiali service mesh
|
|
951
|
+
│ └── vind.py # vCluster (virtual clusters)
|
|
897
952
|
├── resources/ # 8 MCP Resources for data exposure
|
|
898
953
|
├── prompts/ # 8 MCP Prompts for workflows
|
|
899
954
|
└── cli/ # CLI interface
|
|
900
955
|
```
|
|
901
956
|
|
|
902
|
-
## Agent Skills (
|
|
957
|
+
## Agent Skills (25 Skills for AI Coding Agents)
|
|
903
958
|
|
|
904
|
-
Extend your AI coding agent with Kubernetes expertise using our [Agent Skills](https://
|
|
959
|
+
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.
|
|
905
960
|
|
|
906
961
|
### Quick Install
|
|
907
962
|
|
|
@@ -913,7 +968,7 @@ cp -r kubernetes-skills/claude/* ~/.claude/skills/
|
|
|
913
968
|
cp -r kubernetes-skills/claude/k8s-helm ~/.claude/skills/
|
|
914
969
|
```
|
|
915
970
|
|
|
916
|
-
### Available Skills (
|
|
971
|
+
### Available Skills (25)
|
|
917
972
|
|
|
918
973
|
| Category | Skills |
|
|
919
974
|
|----------|--------|
|
|
@@ -923,7 +978,7 @@ cp -r kubernetes-skills/claude/k8s-helm ~/.claude/skills/
|
|
|
923
978
|
| **Security** | k8s-security, k8s-policy, k8s-certs |
|
|
924
979
|
| **GitOps** | k8s-gitops, k8s-rollouts |
|
|
925
980
|
| **Scaling** | k8s-autoscaling, k8s-cost, k8s-backup |
|
|
926
|
-
| **Multi-Cluster** | k8s-multicluster, k8s-capi, k8s-kubevirt |
|
|
981
|
+
| **Multi-Cluster** | k8s-multicluster, k8s-capi, k8s-kubevirt, k8s-vind |
|
|
927
982
|
| **Networking** | k8s-service-mesh, k8s-cilium |
|
|
928
983
|
| **Tools** | k8s-browser, k8s-cli |
|
|
929
984
|
|
|
@@ -951,7 +1006,8 @@ Seamlessly manage multiple Kubernetes clusters through natural language. **Every
|
|
|
951
1006
|
|
|
952
1007
|
### Context Parameter (v1.15.0)
|
|
953
1008
|
|
|
954
|
-
|
|
1009
|
+
Most kubectl-backed tools accept an optional `context` parameter to target specific clusters.
|
|
1010
|
+
Note: vCluster (vind) and kind tools run via their local CLIs and do not accept the `context` parameter.
|
|
955
1011
|
|
|
956
1012
|
**Talk to your AI assistant:**
|
|
957
1013
|
```
|
|
@@ -1040,7 +1096,7 @@ pytest tests/ -v -m unit
|
|
|
1040
1096
|
tests/
|
|
1041
1097
|
├── __init__.py # Test package
|
|
1042
1098
|
├── conftest.py # Shared fixtures and mocks
|
|
1043
|
-
├── test_tools.py # Unit tests for
|
|
1099
|
+
├── test_tools.py # Unit tests for 253 MCP tools
|
|
1044
1100
|
├── test_resources.py # Tests for 8 MCP Resources
|
|
1045
1101
|
├── test_prompts.py # Tests for 8 MCP Prompts
|
|
1046
1102
|
└── test_server.py # Server initialization tests
|
{kubectl_mcp_server-1.19.3 → kubectl_mcp_server-1.22.0}/kubectl_mcp_server.egg-info/SOURCES.txt
RENAMED
|
@@ -52,6 +52,7 @@ kubectl_mcp_tool/tools/gitops.py
|
|
|
52
52
|
kubectl_mcp_tool/tools/helm.py
|
|
53
53
|
kubectl_mcp_tool/tools/keda.py
|
|
54
54
|
kubectl_mcp_tool/tools/kiali.py
|
|
55
|
+
kubectl_mcp_tool/tools/kind.py
|
|
55
56
|
kubectl_mcp_tool/tools/kubevirt.py
|
|
56
57
|
kubectl_mcp_tool/tools/networking.py
|
|
57
58
|
kubectl_mcp_tool/tools/operations.py
|
|
@@ -62,6 +63,7 @@ kubectl_mcp_tool/tools/security.py
|
|
|
62
63
|
kubectl_mcp_tool/tools/storage.py
|
|
63
64
|
kubectl_mcp_tool/tools/ui.py
|
|
64
65
|
kubectl_mcp_tool/tools/utils.py
|
|
66
|
+
kubectl_mcp_tool/tools/vind.py
|
|
65
67
|
kubectl_mcp_tool/utils/__init__.py
|
|
66
68
|
kubectl_mcp_tool/utils/helpers.py
|
|
67
69
|
tests/__init__.py
|
|
@@ -71,10 +73,12 @@ tests/test_browser.py
|
|
|
71
73
|
tests/test_cli.py
|
|
72
74
|
tests/test_config.py
|
|
73
75
|
tests/test_ecosystem.py
|
|
76
|
+
tests/test_kind.py
|
|
74
77
|
tests/test_mcp_integration.py
|
|
75
78
|
tests/test_observability.py
|
|
76
79
|
tests/test_prompts.py
|
|
77
80
|
tests/test_resources.py
|
|
78
81
|
tests/test_safety.py
|
|
79
82
|
tests/test_server.py
|
|
80
|
-
tests/test_tools.py
|
|
83
|
+
tests/test_tools.py
|
|
84
|
+
tests/test_vind.py
|