kubectl-mcp-server 1.19.0__tar.gz → 1.19.2__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.
Files changed (83) hide show
  1. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/PKG-INFO +88 -18
  2. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/README.md +86 -16
  3. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_server.egg-info/PKG-INFO +88 -18
  4. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_server.egg-info/SOURCES.txt +2 -0
  5. kubectl_mcp_server-1.19.2/kubectl_mcp_tool/k8s_config.py +549 -0
  6. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/mcp_server.py +30 -0
  7. kubectl_mcp_server-1.19.2/kubectl_mcp_tool/providers.py +347 -0
  8. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/__init__.py +2 -1
  9. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/backup.py +10 -47
  10. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/capi.py +12 -56
  11. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/certs.py +11 -29
  12. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/cilium.py +10 -47
  13. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/cluster.py +489 -9
  14. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/gitops.py +12 -51
  15. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/keda.py +9 -47
  16. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/kiali.py +10 -50
  17. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/kubevirt.py +11 -49
  18. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/pods.py +93 -0
  19. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/policy.py +11 -49
  20. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/rollouts.py +11 -65
  21. kubectl_mcp_server-1.19.2/kubectl_mcp_tool/tools/utils.py +41 -0
  22. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/setup.py +2 -2
  23. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/tests/test_tools.py +44 -11
  24. kubectl_mcp_server-1.19.0/kubectl_mcp_tool/k8s_config.py +0 -530
  25. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/LICENSE +0 -0
  26. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_server.egg-info/dependency_links.txt +0 -0
  27. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_server.egg-info/entry_points.txt +0 -0
  28. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_server.egg-info/requires.txt +0 -0
  29. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_server.egg-info/top_level.txt +0 -0
  30. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/__init__.py +0 -0
  31. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/__main__.py +0 -0
  32. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/auth/__init__.py +0 -0
  33. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/auth/config.py +0 -0
  34. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/auth/scopes.py +0 -0
  35. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/auth/verifier.py +0 -0
  36. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/cli/__init__.py +0 -0
  37. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/cli/__main__.py +0 -0
  38. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/cli/cli.py +0 -0
  39. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/cli/errors.py +0 -0
  40. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/cli/output.py +0 -0
  41. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/config/__init__.py +0 -0
  42. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/config/loader.py +0 -0
  43. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/config/schema.py +0 -0
  44. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/crd_detector.py +0 -0
  45. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/diagnostics.py +0 -0
  46. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/observability/__init__.py +0 -0
  47. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/observability/metrics.py +0 -0
  48. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/observability/stats.py +0 -0
  49. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/observability/tracing.py +0 -0
  50. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/prompts/__init__.py +0 -0
  51. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/prompts/builtin.py +0 -0
  52. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/prompts/custom.py +0 -0
  53. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/prompts/prompts.py +0 -0
  54. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/resources/__init__.py +0 -0
  55. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/resources/resources.py +0 -0
  56. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/safety.py +0 -0
  57. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/browser.py +0 -0
  58. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/core.py +0 -0
  59. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/cost.py +0 -0
  60. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/deployments.py +0 -0
  61. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/diagnostics.py +0 -0
  62. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/helm.py +0 -0
  63. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/networking.py +0 -0
  64. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/operations.py +0 -0
  65. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/security.py +0 -0
  66. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/storage.py +0 -0
  67. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/tools/ui.py +0 -0
  68. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/utils/__init__.py +0 -0
  69. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/kubectl_mcp_tool/utils/helpers.py +0 -0
  70. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/setup.cfg +0 -0
  71. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/tests/__init__.py +0 -0
  72. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/tests/conftest.py +0 -0
  73. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/tests/test_auth.py +0 -0
  74. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/tests/test_browser.py +0 -0
  75. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/tests/test_cli.py +0 -0
  76. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/tests/test_config.py +0 -0
  77. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/tests/test_ecosystem.py +0 -0
  78. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/tests/test_mcp_integration.py +0 -0
  79. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/tests/test_observability.py +0 -0
  80. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/tests/test_prompts.py +0 -0
  81. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/tests/test_resources.py +0 -0
  82. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/tests/test_safety.py +0 -0
  83. {kubectl_mcp_server-1.19.0 → kubectl_mcp_server-1.19.2}/tests/test_server.py +0 -0
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: kubectl-mcp-server
3
- Version: 1.19.0
4
- Summary: A Model Context Protocol (MCP) server for Kubernetes with 220+ tools, 8 resources, and 8 prompts
3
+ Version: 1.19.2
4
+ Summary: A Model Context Protocol (MCP) server for Kubernetes with 235+ 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
@@ -56,22 +56,32 @@ Dynamic: requires-dist
56
56
  Dynamic: requires-python
57
57
  Dynamic: summary
58
58
 
59
- # Kubectl MCP Server
60
-
61
- **Control your entire Kubernetes infrastructure through natural language conversations with AI.**
62
-
63
- Talk to your clusters like you talk to a DevOps expert. Debug crashed pods, optimize costs, deploy applications, audit security, manage Helm charts, and visualize dashboards, all through natural language in your favorite AI assistant or agents.
64
-
65
- [![GitHub Stars](https://img.shields.io/github/stars/rohitg00/kubectl-mcp-server?style=flat&logo=github)](https://github.com/rohitg00/kubectl-mcp-server)
66
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
67
- [![Python](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/)
68
- [![Kubernetes](https://img.shields.io/badge/kubernetes-%23326ce5.svg?style=flat&logo=kubernetes&logoColor=white)](https://kubernetes.io/)
69
- [![MCP](https://img.shields.io/badge/MCP-compatible-green.svg)](https://modelcontextprotocol.io)
70
- [![PyPI](https://img.shields.io/pypi/v/kubectl-mcp-server?color=blue&label=PyPI)](https://pypi.org/project/kubectl-mcp-server/)
71
- [![npm](https://img.shields.io/npm/v/kubectl-mcp-server?color=green&label=npm)](https://www.npmjs.com/package/kubectl-mcp-server)
72
- [![Docker](https://img.shields.io/docker/pulls/rohitghumare64/kubectl-mcp-server.svg)](https://hub.docker.com/r/rohitghumare64/kubectl-mcp-server)
73
- [![Tests](https://img.shields.io/badge/tests-234%20passed-success)](https://github.com/rohitg00/kubectl-mcp-server)
74
- [![agentregistry](https://img.shields.io/badge/agentregistry-verified-blue?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgZmlsbD0id2hpdGUiIHZpZXdCb3g9IjAgMCAxNiAxNiI+PHBhdGggZD0iTTE1Ljk5MiA2LjAzN2wtMy4wMjEtLjQzOS0xLjM1LTIuNzM2Yy0uMzQ2LS43MDItMS41MDQtLjcwMi0xLjg1IDBMOC40MjEgNS41OTggNS40IDYuMDM3Yy0uNzc2LjExMy0xLjA4OCAxLjA1My0uNTI4IDEuNTkzbDIuMTg2IDIuMTI5LS41MTYgMy4wMWMtLjEzMy43NzUuNjgyIDEuMzY2IDEuMzc4Ljk5OGwyLjcwMi0xLjQyIDIuNzAyIDEuNDJjLjY5Ni4zNjggMS41MTEtLjIyMyAxLjM3OC0uOTk4bC0uNTE2LTMuMDEgMi4xODYtMi4xMjljLjU2LS41NCAwLjI0OC0xLjQ4LS41MjgtMS41OTN6Ii8+PC9zdmc+)](https://aregistry.ai)
59
+ <p align="center">
60
+ <img src="logos/kubectl-mcp-server-icon.svg" alt="kubectl-mcp-server logo" width="80" height="80">
61
+ <br>
62
+ <strong style="font-size: 24px;">kubectl-mcp-server</strong>
63
+ </p>
64
+
65
+ <p align="center">
66
+ <b>Control your entire Kubernetes infrastructure through natural language conversations with AI.</b><br>
67
+ Talk to your clusters like you talk to a DevOps expert. Debug crashed pods, optimize costs, deploy applications, audit security, manage Helm charts, and visualize dashboards—all through natural language.
68
+ </p>
69
+
70
+ <p align="center">
71
+ <a href="https://github.com/rohitg00/kubectl-mcp-server"><img src="https://img.shields.io/github/stars/rohitg00/kubectl-mcp-server?style=flat&logo=github" alt="GitHub Stars"></a>
72
+ <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
73
+ <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="Python"></a>
74
+ <a href="https://kubernetes.io/"><img src="https://img.shields.io/badge/kubernetes-%23326ce5.svg?style=flat&logo=kubernetes&logoColor=white" alt="Kubernetes"></a>
75
+ <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-green.svg" alt="MCP"></a>
76
+ </p>
77
+
78
+ <p align="center">
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
+ <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
+ <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" alt="Tests"></a>
83
+ <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
+ </p>
75
85
 
76
86
  ---
77
87
 
@@ -121,6 +131,7 @@ pip install kubectl-mcp-server[ui]
121
131
  - [In-Cluster Deployment](#in-cluster-deployment)
122
132
  - [Multi-Cluster Support](#multi-cluster-support)
123
133
  - [Architecture](#architecture)
134
+ - [Agent Skills](#agent-skills-24-skills-for-ai-coding-agents)
124
135
  - [Development & Testing](#development--testing)
125
136
  - [Contributing](#contributing)
126
137
  - [Support & Community](#support--community)
@@ -203,6 +214,19 @@ pip install kubectl-mcp-server
203
214
  pip install kubectl-mcp-server[ui]
204
215
  ```
205
216
 
217
+ ### Install from GitHub Release
218
+
219
+ ```bash
220
+ # Install specific version directly from GitHub release (replace {VERSION} with desired version)
221
+ pip install https://github.com/rohitg00/kubectl-mcp-server/releases/download/v{VERSION}/kubectl_mcp_server-{VERSION}-py3-none-any.whl
222
+
223
+ # Example: Install v1.19.0
224
+ pip install https://github.com/rohitg00/kubectl-mcp-server/releases/download/v1.19.0/kubectl_mcp_server-1.19.0-py3-none-any.whl
225
+
226
+ # Or install latest from git
227
+ pip install git+https://github.com/rohitg00/kubectl-mcp-server.git
228
+ ```
229
+
206
230
  ### Prerequisites
207
231
  - **Python 3.9+** (for pip installation)
208
232
  - **Node.js 14+** (for npx installation)
@@ -875,6 +899,52 @@ kubectl_mcp_tool/
875
899
  └── cli/ # CLI interface
876
900
  ```
877
901
 
902
+ ## Agent Skills (24 Skills for AI Coding Agents)
903
+
904
+ 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.
905
+
906
+ ### Quick Install
907
+
908
+ ```bash
909
+ # Copy all skills to Claude
910
+ cp -r kubernetes-skills/claude/* ~/.claude/skills/
911
+
912
+ # Or install specific skills
913
+ cp -r kubernetes-skills/claude/k8s-helm ~/.claude/skills/
914
+ ```
915
+
916
+ ### Available Skills (24)
917
+
918
+ | Category | Skills |
919
+ |----------|--------|
920
+ | **Core Resources** | k8s-core, k8s-networking, k8s-storage |
921
+ | **Workloads** | k8s-deploy, k8s-operations, k8s-helm |
922
+ | **Observability** | k8s-diagnostics, k8s-troubleshoot, k8s-incident |
923
+ | **Security** | k8s-security, k8s-policy, k8s-certs |
924
+ | **GitOps** | k8s-gitops, k8s-rollouts |
925
+ | **Scaling** | k8s-autoscaling, k8s-cost, k8s-backup |
926
+ | **Multi-Cluster** | k8s-multicluster, k8s-capi, k8s-kubevirt |
927
+ | **Networking** | k8s-service-mesh, k8s-cilium |
928
+ | **Tools** | k8s-browser, k8s-cli |
929
+
930
+ ### Convert to Other Agents
931
+
932
+ Use [SkillKit](https://github.com/rohitg00/skillkit) to convert skills to your preferred AI agent format:
933
+
934
+ ```bash
935
+ npm install -g skillkit
936
+
937
+ # Convert to Cursor format
938
+ skillkit translate kubernetes-skills/claude --to cursor --output .cursor/rules/
939
+
940
+ # Convert to Codex format
941
+ skillkit translate kubernetes-skills/claude --to codex --output ./
942
+ ```
943
+
944
+ **Supported agents:** Claude, Cursor, Codex, Gemini CLI, GitHub Copilot, Goose, Windsurf, Roo, Amp, and more.
945
+
946
+ See [kubernetes-skills/README.md](kubernetes-skills/README.md) for full documentation.
947
+
878
948
  ## Multi-Cluster Support
879
949
 
880
950
  Seamlessly manage multiple Kubernetes clusters through natural language. **Every tool** supports an optional `context` parameter to target any cluster without switching contexts.
@@ -1,19 +1,29 @@
1
- # Kubectl MCP Server
2
-
3
- **Control your entire Kubernetes infrastructure through natural language conversations with AI.**
4
-
5
- Talk to your clusters like you talk to a DevOps expert. Debug crashed pods, optimize costs, deploy applications, audit security, manage Helm charts, and visualize dashboards, all through natural language in your favorite AI assistant or agents.
6
-
7
- [![GitHub Stars](https://img.shields.io/github/stars/rohitg00/kubectl-mcp-server?style=flat&logo=github)](https://github.com/rohitg00/kubectl-mcp-server)
8
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
9
- [![Python](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/)
10
- [![Kubernetes](https://img.shields.io/badge/kubernetes-%23326ce5.svg?style=flat&logo=kubernetes&logoColor=white)](https://kubernetes.io/)
11
- [![MCP](https://img.shields.io/badge/MCP-compatible-green.svg)](https://modelcontextprotocol.io)
12
- [![PyPI](https://img.shields.io/pypi/v/kubectl-mcp-server?color=blue&label=PyPI)](https://pypi.org/project/kubectl-mcp-server/)
13
- [![npm](https://img.shields.io/npm/v/kubectl-mcp-server?color=green&label=npm)](https://www.npmjs.com/package/kubectl-mcp-server)
14
- [![Docker](https://img.shields.io/docker/pulls/rohitghumare64/kubectl-mcp-server.svg)](https://hub.docker.com/r/rohitghumare64/kubectl-mcp-server)
15
- [![Tests](https://img.shields.io/badge/tests-234%20passed-success)](https://github.com/rohitg00/kubectl-mcp-server)
16
- [![agentregistry](https://img.shields.io/badge/agentregistry-verified-blue?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgZmlsbD0id2hpdGUiIHZpZXdCb3g9IjAgMCAxNiAxNiI+PHBhdGggZD0iTTE1Ljk5MiA2LjAzN2wtMy4wMjEtLjQzOS0xLjM1LTIuNzM2Yy0uMzQ2LS43MDItMS41MDQtLjcwMi0xLjg1IDBMOC40MjEgNS41OTggNS40IDYuMDM3Yy0uNzc2LjExMy0xLjA4OCAxLjA1My0uNTI4IDEuNTkzbDIuMTg2IDIuMTI5LS41MTYgMy4wMWMtLjEzMy43NzUuNjgyIDEuMzY2IDEuMzc4Ljk5OGwyLjcwMi0xLjQyIDIuNzAyIDEuNDJjLjY5Ni4zNjggMS41MTEtLjIyMyAxLjM3OC0uOTk4bC0uNTE2LTMuMDEgMi4xODYtMi4xMjljLjU2LS41NCAwLjI0OC0xLjQ4LS41MjgtMS41OTN6Ii8+PC9zdmc+)](https://aregistry.ai)
1
+ <p align="center">
2
+ <img src="logos/kubectl-mcp-server-icon.svg" alt="kubectl-mcp-server logo" width="80" height="80">
3
+ <br>
4
+ <strong style="font-size: 24px;">kubectl-mcp-server</strong>
5
+ </p>
6
+
7
+ <p align="center">
8
+ <b>Control your entire Kubernetes infrastructure through natural language conversations with AI.</b><br>
9
+ Talk to your clusters like you talk to a DevOps expert. Debug crashed pods, optimize costs, deploy applications, audit security, manage Helm charts, and visualize dashboards—all through natural language.
10
+ </p>
11
+
12
+ <p align="center">
13
+ <a href="https://github.com/rohitg00/kubectl-mcp-server"><img src="https://img.shields.io/github/stars/rohitg00/kubectl-mcp-server?style=flat&logo=github" alt="GitHub Stars"></a>
14
+ <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
15
+ <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="Python"></a>
16
+ <a href="https://kubernetes.io/"><img src="https://img.shields.io/badge/kubernetes-%23326ce5.svg?style=flat&logo=kubernetes&logoColor=white" alt="Kubernetes"></a>
17
+ <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-green.svg" alt="MCP"></a>
18
+ </p>
19
+
20
+ <p align="center">
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
+ <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
+ <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>
25
+ <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
+ </p>
17
27
 
18
28
  ---
19
29
 
@@ -63,6 +73,7 @@ pip install kubectl-mcp-server[ui]
63
73
  - [In-Cluster Deployment](#in-cluster-deployment)
64
74
  - [Multi-Cluster Support](#multi-cluster-support)
65
75
  - [Architecture](#architecture)
76
+ - [Agent Skills](#agent-skills-24-skills-for-ai-coding-agents)
66
77
  - [Development & Testing](#development--testing)
67
78
  - [Contributing](#contributing)
68
79
  - [Support & Community](#support--community)
@@ -145,6 +156,19 @@ pip install kubectl-mcp-server
145
156
  pip install kubectl-mcp-server[ui]
146
157
  ```
147
158
 
159
+ ### Install from GitHub Release
160
+
161
+ ```bash
162
+ # Install specific version directly from GitHub release (replace {VERSION} with desired version)
163
+ pip install https://github.com/rohitg00/kubectl-mcp-server/releases/download/v{VERSION}/kubectl_mcp_server-{VERSION}-py3-none-any.whl
164
+
165
+ # Example: Install v1.19.0
166
+ pip install https://github.com/rohitg00/kubectl-mcp-server/releases/download/v1.19.0/kubectl_mcp_server-1.19.0-py3-none-any.whl
167
+
168
+ # Or install latest from git
169
+ pip install git+https://github.com/rohitg00/kubectl-mcp-server.git
170
+ ```
171
+
148
172
  ### Prerequisites
149
173
  - **Python 3.9+** (for pip installation)
150
174
  - **Node.js 14+** (for npx installation)
@@ -817,6 +841,52 @@ kubectl_mcp_tool/
817
841
  └── cli/ # CLI interface
818
842
  ```
819
843
 
844
+ ## Agent Skills (24 Skills for AI Coding Agents)
845
+
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.
847
+
848
+ ### Quick Install
849
+
850
+ ```bash
851
+ # Copy all skills to Claude
852
+ cp -r kubernetes-skills/claude/* ~/.claude/skills/
853
+
854
+ # Or install specific skills
855
+ cp -r kubernetes-skills/claude/k8s-helm ~/.claude/skills/
856
+ ```
857
+
858
+ ### Available Skills (24)
859
+
860
+ | Category | Skills |
861
+ |----------|--------|
862
+ | **Core Resources** | k8s-core, k8s-networking, k8s-storage |
863
+ | **Workloads** | k8s-deploy, k8s-operations, k8s-helm |
864
+ | **Observability** | k8s-diagnostics, k8s-troubleshoot, k8s-incident |
865
+ | **Security** | k8s-security, k8s-policy, k8s-certs |
866
+ | **GitOps** | k8s-gitops, k8s-rollouts |
867
+ | **Scaling** | k8s-autoscaling, k8s-cost, k8s-backup |
868
+ | **Multi-Cluster** | k8s-multicluster, k8s-capi, k8s-kubevirt |
869
+ | **Networking** | k8s-service-mesh, k8s-cilium |
870
+ | **Tools** | k8s-browser, k8s-cli |
871
+
872
+ ### Convert to Other Agents
873
+
874
+ Use [SkillKit](https://github.com/rohitg00/skillkit) to convert skills to your preferred AI agent format:
875
+
876
+ ```bash
877
+ npm install -g skillkit
878
+
879
+ # Convert to Cursor format
880
+ skillkit translate kubernetes-skills/claude --to cursor --output .cursor/rules/
881
+
882
+ # Convert to Codex format
883
+ skillkit translate kubernetes-skills/claude --to codex --output ./
884
+ ```
885
+
886
+ **Supported agents:** Claude, Cursor, Codex, Gemini CLI, GitHub Copilot, Goose, Windsurf, Roo, Amp, and more.
887
+
888
+ See [kubernetes-skills/README.md](kubernetes-skills/README.md) for full documentation.
889
+
820
890
  ## Multi-Cluster Support
821
891
 
822
892
  Seamlessly manage multiple Kubernetes clusters through natural language. **Every tool** supports an optional `context` parameter to target any cluster without switching contexts.
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: kubectl-mcp-server
3
- Version: 1.19.0
4
- Summary: A Model Context Protocol (MCP) server for Kubernetes with 220+ tools, 8 resources, and 8 prompts
3
+ Version: 1.19.2
4
+ Summary: A Model Context Protocol (MCP) server for Kubernetes with 235+ 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
@@ -56,22 +56,32 @@ Dynamic: requires-dist
56
56
  Dynamic: requires-python
57
57
  Dynamic: summary
58
58
 
59
- # Kubectl MCP Server
60
-
61
- **Control your entire Kubernetes infrastructure through natural language conversations with AI.**
62
-
63
- Talk to your clusters like you talk to a DevOps expert. Debug crashed pods, optimize costs, deploy applications, audit security, manage Helm charts, and visualize dashboards, all through natural language in your favorite AI assistant or agents.
64
-
65
- [![GitHub Stars](https://img.shields.io/github/stars/rohitg00/kubectl-mcp-server?style=flat&logo=github)](https://github.com/rohitg00/kubectl-mcp-server)
66
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
67
- [![Python](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/)
68
- [![Kubernetes](https://img.shields.io/badge/kubernetes-%23326ce5.svg?style=flat&logo=kubernetes&logoColor=white)](https://kubernetes.io/)
69
- [![MCP](https://img.shields.io/badge/MCP-compatible-green.svg)](https://modelcontextprotocol.io)
70
- [![PyPI](https://img.shields.io/pypi/v/kubectl-mcp-server?color=blue&label=PyPI)](https://pypi.org/project/kubectl-mcp-server/)
71
- [![npm](https://img.shields.io/npm/v/kubectl-mcp-server?color=green&label=npm)](https://www.npmjs.com/package/kubectl-mcp-server)
72
- [![Docker](https://img.shields.io/docker/pulls/rohitghumare64/kubectl-mcp-server.svg)](https://hub.docker.com/r/rohitghumare64/kubectl-mcp-server)
73
- [![Tests](https://img.shields.io/badge/tests-234%20passed-success)](https://github.com/rohitg00/kubectl-mcp-server)
74
- [![agentregistry](https://img.shields.io/badge/agentregistry-verified-blue?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgZmlsbD0id2hpdGUiIHZpZXdCb3g9IjAgMCAxNiAxNiI+PHBhdGggZD0iTTE1Ljk5MiA2LjAzN2wtMy4wMjEtLjQzOS0xLjM1LTIuNzM2Yy0uMzQ2LS43MDItMS41MDQtLjcwMi0xLjg1IDBMOC40MjEgNS41OTggNS40IDYuMDM3Yy0uNzc2LjExMy0xLjA4OCAxLjA1My0uNTI4IDEuNTkzbDIuMTg2IDIuMTI5LS41MTYgMy4wMWMtLjEzMy43NzUuNjgyIDEuMzY2IDEuMzc4Ljk5OGwyLjcwMi0xLjQyIDIuNzAyIDEuNDJjLjY5Ni4zNjggMS41MTEtLjIyMyAxLjM3OC0uOTk4bC0uNTE2LTMuMDEgMi4xODYtMi4xMjljLjU2LS41NCAwLjI0OC0xLjQ4LS41MjgtMS41OTN6Ii8+PC9zdmc+)](https://aregistry.ai)
59
+ <p align="center">
60
+ <img src="logos/kubectl-mcp-server-icon.svg" alt="kubectl-mcp-server logo" width="80" height="80">
61
+ <br>
62
+ <strong style="font-size: 24px;">kubectl-mcp-server</strong>
63
+ </p>
64
+
65
+ <p align="center">
66
+ <b>Control your entire Kubernetes infrastructure through natural language conversations with AI.</b><br>
67
+ Talk to your clusters like you talk to a DevOps expert. Debug crashed pods, optimize costs, deploy applications, audit security, manage Helm charts, and visualize dashboards—all through natural language.
68
+ </p>
69
+
70
+ <p align="center">
71
+ <a href="https://github.com/rohitg00/kubectl-mcp-server"><img src="https://img.shields.io/github/stars/rohitg00/kubectl-mcp-server?style=flat&logo=github" alt="GitHub Stars"></a>
72
+ <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
73
+ <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="Python"></a>
74
+ <a href="https://kubernetes.io/"><img src="https://img.shields.io/badge/kubernetes-%23326ce5.svg?style=flat&logo=kubernetes&logoColor=white" alt="Kubernetes"></a>
75
+ <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-green.svg" alt="MCP"></a>
76
+ </p>
77
+
78
+ <p align="center">
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
+ <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
+ <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" alt="Tests"></a>
83
+ <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
+ </p>
75
85
 
76
86
  ---
77
87
 
@@ -121,6 +131,7 @@ pip install kubectl-mcp-server[ui]
121
131
  - [In-Cluster Deployment](#in-cluster-deployment)
122
132
  - [Multi-Cluster Support](#multi-cluster-support)
123
133
  - [Architecture](#architecture)
134
+ - [Agent Skills](#agent-skills-24-skills-for-ai-coding-agents)
124
135
  - [Development & Testing](#development--testing)
125
136
  - [Contributing](#contributing)
126
137
  - [Support & Community](#support--community)
@@ -203,6 +214,19 @@ pip install kubectl-mcp-server
203
214
  pip install kubectl-mcp-server[ui]
204
215
  ```
205
216
 
217
+ ### Install from GitHub Release
218
+
219
+ ```bash
220
+ # Install specific version directly from GitHub release (replace {VERSION} with desired version)
221
+ pip install https://github.com/rohitg00/kubectl-mcp-server/releases/download/v{VERSION}/kubectl_mcp_server-{VERSION}-py3-none-any.whl
222
+
223
+ # Example: Install v1.19.0
224
+ pip install https://github.com/rohitg00/kubectl-mcp-server/releases/download/v1.19.0/kubectl_mcp_server-1.19.0-py3-none-any.whl
225
+
226
+ # Or install latest from git
227
+ pip install git+https://github.com/rohitg00/kubectl-mcp-server.git
228
+ ```
229
+
206
230
  ### Prerequisites
207
231
  - **Python 3.9+** (for pip installation)
208
232
  - **Node.js 14+** (for npx installation)
@@ -875,6 +899,52 @@ kubectl_mcp_tool/
875
899
  └── cli/ # CLI interface
876
900
  ```
877
901
 
902
+ ## Agent Skills (24 Skills for AI Coding Agents)
903
+
904
+ 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.
905
+
906
+ ### Quick Install
907
+
908
+ ```bash
909
+ # Copy all skills to Claude
910
+ cp -r kubernetes-skills/claude/* ~/.claude/skills/
911
+
912
+ # Or install specific skills
913
+ cp -r kubernetes-skills/claude/k8s-helm ~/.claude/skills/
914
+ ```
915
+
916
+ ### Available Skills (24)
917
+
918
+ | Category | Skills |
919
+ |----------|--------|
920
+ | **Core Resources** | k8s-core, k8s-networking, k8s-storage |
921
+ | **Workloads** | k8s-deploy, k8s-operations, k8s-helm |
922
+ | **Observability** | k8s-diagnostics, k8s-troubleshoot, k8s-incident |
923
+ | **Security** | k8s-security, k8s-policy, k8s-certs |
924
+ | **GitOps** | k8s-gitops, k8s-rollouts |
925
+ | **Scaling** | k8s-autoscaling, k8s-cost, k8s-backup |
926
+ | **Multi-Cluster** | k8s-multicluster, k8s-capi, k8s-kubevirt |
927
+ | **Networking** | k8s-service-mesh, k8s-cilium |
928
+ | **Tools** | k8s-browser, k8s-cli |
929
+
930
+ ### Convert to Other Agents
931
+
932
+ Use [SkillKit](https://github.com/rohitg00/skillkit) to convert skills to your preferred AI agent format:
933
+
934
+ ```bash
935
+ npm install -g skillkit
936
+
937
+ # Convert to Cursor format
938
+ skillkit translate kubernetes-skills/claude --to cursor --output .cursor/rules/
939
+
940
+ # Convert to Codex format
941
+ skillkit translate kubernetes-skills/claude --to codex --output ./
942
+ ```
943
+
944
+ **Supported agents:** Claude, Cursor, Codex, Gemini CLI, GitHub Copilot, Goose, Windsurf, Roo, Amp, and more.
945
+
946
+ See [kubernetes-skills/README.md](kubernetes-skills/README.md) for full documentation.
947
+
878
948
  ## Multi-Cluster Support
879
949
 
880
950
  Seamlessly manage multiple Kubernetes clusters through natural language. **Every tool** supports an optional `context` parameter to target any cluster without switching contexts.
@@ -13,6 +13,7 @@ kubectl_mcp_tool/crd_detector.py
13
13
  kubectl_mcp_tool/diagnostics.py
14
14
  kubectl_mcp_tool/k8s_config.py
15
15
  kubectl_mcp_tool/mcp_server.py
16
+ kubectl_mcp_tool/providers.py
16
17
  kubectl_mcp_tool/safety.py
17
18
  kubectl_mcp_tool/auth/__init__.py
18
19
  kubectl_mcp_tool/auth/config.py
@@ -60,6 +61,7 @@ kubectl_mcp_tool/tools/rollouts.py
60
61
  kubectl_mcp_tool/tools/security.py
61
62
  kubectl_mcp_tool/tools/storage.py
62
63
  kubectl_mcp_tool/tools/ui.py
64
+ kubectl_mcp_tool/tools/utils.py
63
65
  kubectl_mcp_tool/utils/__init__.py
64
66
  kubectl_mcp_tool/utils/helpers.py
65
67
  tests/__init__.py