kubectl-mcp-server 1.10.0 → 1.12.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 +100 -3
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -2,14 +2,16 @@
2
2
 
3
3
  A Model Context Protocol (MCP) server for Kubernetes that enables AI assistants like Claude, Cursor, and others to interact with Kubernetes clusters through natural language.
4
4
 
5
+ [![GitHub Stars](https://img.shields.io/github/stars/rohitg00/kubectl-mcp-server?style=flat&logo=github)](https://github.com/rohitg00/kubectl-mcp-server)
5
6
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6
7
  [![Python](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/)
7
8
  [![Kubernetes](https://img.shields.io/badge/kubernetes-%23326ce5.svg?style=flat&logo=kubernetes&logoColor=white)](https://kubernetes.io/)
8
9
  [![MCP](https://img.shields.io/badge/MCP-compatible-green.svg)](https://modelcontextprotocol.io)
9
- [![PyPI](https://img.shields.io/pypi/v/kubectl-mcp-tool?color=blue&label=PyPI)](https://pypi.org/project/kubectl-mcp-tool/)
10
+ [![PyPI](https://img.shields.io/pypi/v/kubectl-mcp-server?color=blue&label=PyPI)](https://pypi.org/project/kubectl-mcp-server/)
10
11
  [![npm](https://img.shields.io/npm/v/kubectl-mcp-server?color=green&label=npm)](https://www.npmjs.com/package/kubectl-mcp-server)
11
12
  [![Docker](https://img.shields.io/docker/pulls/rohitghumare64/kubectl-mcp-server.svg)](https://hub.docker.com/r/rohitghumare64/kubectl-mcp-server)
12
- [![Tests](https://img.shields.io/badge/tests-167%20passed-success)](https://github.com/rohitg00/kubectl-mcp-server)
13
+ [![Tests](https://img.shields.io/badge/tests-187%20passed-success)](https://github.com/rohitg00/kubectl-mcp-server)
14
+ [![agentregistry](https://img.shields.io/badge/agentregistry-verified-blue?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgZmlsbD0id2hpdGUiIHZpZXdCb3g9IjAgMCAxNiAxNiI+PHBhdGggZD0iTTE1Ljk5MiA2LjAzN2wtMy4wMjEtLjQzOS0xLjM1LTIuNzM2Yy0uMzQ2LS43MDItMS41MDQtLjcwMi0xLjg1IDBMOC40MjEgNS41OTggNS40IDYuMDM3Yy0uNzc2LjExMy0xLjA4OCAxLjA1My0uNTI4IDEuNTkzbDIuMTg2IDIuMTI5LS41MTYgMy4wMWMtLjEzMy43NzUuNjgyIDEuMzY2IDEuMzc4Ljk5OGwyLjcwMi0xLjQyIDIuNzAyIDEuNDJjLjY5Ni4zNjggMS41MTEtLjIyMyAxLjM3OC0uOTk4bC0uNTE2LTMuMDEgMi4xODYtMi4xMjljLjU2LS41NCAwLjI0OC0xLjQ4LS41MjgtMS41OTN6Ii8+PC9zdmc+)](https://aregistry.ai)
13
15
 
14
16
  ## MCP Client Compatibility
15
17
 
@@ -132,6 +134,9 @@ npm install -g kubectl-mcp-server
132
134
  ### pip (Python)
133
135
 
134
136
  ```bash
137
+ pip install kubectl-mcp-server
138
+
139
+ # Legacy alias (still works for backward compatibility)
135
140
  pip install kubectl-mcp-tool
136
141
  ```
137
142
 
@@ -325,6 +330,60 @@ python -m kubectl_mcp_tool.mcp_server --transport http --port 8000
325
330
  | `MCP_AUTH_AUDIENCE` | Expected token audience (default: `kubectl-mcp-server`) |
326
331
  | `MCP_AUTH_REQUIRED_SCOPES` | Required scopes (default: `mcp:tools`) |
327
332
 
333
+ ### Browser Automation (Optional)
334
+
335
+ | Variable | Description |
336
+ |----------|-------------|
337
+ | `MCP_BROWSER_ENABLED` | Enable browser automation tools (default: `false`) |
338
+
339
+ ## Browser Tools (Optional Module)
340
+
341
+ Enable browser automation for web-based K8s operations using [agent-browser](https://github.com/vercel-labs/agent-browser).
342
+
343
+ ### Setup
344
+
345
+ ```bash
346
+ # Install agent-browser
347
+ npm install -g agent-browser
348
+ agent-browser install # Download Chromium
349
+
350
+ # Enable browser tools
351
+ export MCP_BROWSER_ENABLED=true
352
+ kubectl-mcp-server
353
+ ```
354
+
355
+ ### 19 Browser Tools
356
+
357
+ | Tool | Description |
358
+ |------|-------------|
359
+ | `browser_open` | Open URL in browser |
360
+ | `browser_snapshot` | Get page accessibility tree |
361
+ | `browser_click` | Click element by ref |
362
+ | `browser_fill` | Fill form field |
363
+ | `browser_screenshot` | Take screenshot |
364
+ | `browser_get_text` | Get element text |
365
+ | `browser_get_url` | Get current URL |
366
+ | `browser_wait` | Wait for element/text/timeout |
367
+ | `browser_close` | Close browser |
368
+ | `browser_test_ingress` | Test K8s service via Ingress |
369
+ | `browser_screenshot_service` | Screenshot K8s service UI |
370
+ | `browser_screenshot_grafana` | Screenshot Grafana dashboard |
371
+ | `browser_screenshot_argocd` | Screenshot ArgoCD app |
372
+ | `browser_health_check` | Health check web app |
373
+ | `browser_form_submit` | Fill and submit form |
374
+ | `browser_session_save` | Save browser session |
375
+ | `browser_session_load` | Load browser session |
376
+ | `browser_open_cloud_console` | Open EKS/GKE/AKS console |
377
+ | `browser_pdf_export` | Export page as PDF |
378
+
379
+ ### Use Cases
380
+
381
+ - **Test deployed apps** via Ingress URLs
382
+ - **Screenshot Grafana/ArgoCD** dashboards
383
+ - **Automate cloud console** operations (EKS, GKE, AKS)
384
+ - **Health check** web applications
385
+ - **Export monitoring dashboards** as PDF
386
+
328
387
  ## MCP Authorization (RFC 9728)
329
388
 
330
389
  For enterprise deployments, kubectl-mcp-server supports OAuth 2.1 authentication.
@@ -354,6 +413,43 @@ docker mcp server enable kubectl-mcp-server
354
413
  docker mcp client connect claude
355
414
  ```
356
415
 
416
+ ## agentregistry
417
+
418
+ kubectl-mcp-server is published to [agentregistry](https://github.com/agentregistry-dev/agentregistry), a centralized registry for MCP servers.
419
+
420
+ ### Install with arctl
421
+
422
+ ```bash
423
+ # Install arctl CLI
424
+ curl -fsSL https://raw.githubusercontent.com/agentregistry-dev/agentregistry/main/scripts/install.sh | bash
425
+
426
+ # Search for kubectl-mcp-server
427
+ arctl mcp search kubectl
428
+
429
+ # Install the server
430
+ arctl mcp install io.github.rohitg00/kubectl-mcp-server
431
+ ```
432
+
433
+ ### Available Packages
434
+
435
+ | Registry | Identifier |
436
+ |----------|------------|
437
+ | **PyPI** | `kubectl-mcp-server` (uvx) |
438
+ | **npm** | `kubectl-mcp-server` (npx) |
439
+ | **OCI** | `docker.io/rohitghumare64/kubectl-mcp-server` |
440
+
441
+ ### agentgateway Integration
442
+
443
+ Use with [agentgateway](https://github.com/agentgateway/agentgateway) for unified MCP routing:
444
+
445
+ ```bash
446
+ # Install agentgateway
447
+ cargo install agentgateway
448
+
449
+ # Configure kubectl-mcp-server as upstream
450
+ agentgateway --config gateway.yaml
451
+ ```
452
+
357
453
  ## Kubernetes Deployment
358
454
 
359
455
  Deploy kubectl-mcp-server directly in your Kubernetes cluster for centralized access.
@@ -555,7 +651,8 @@ MIT License - see [LICENSE](LICENSE) for details.
555
651
 
556
652
  ## Links
557
653
 
558
- - [PyPI Package](https://pypi.org/project/kubectl-mcp-tool/)
654
+ - [PyPI Package](https://pypi.org/project/kubectl-mcp-server/)
559
655
  - [npm Package](https://www.npmjs.com/package/kubectl-mcp-server)
560
656
  - [Docker Hub](https://hub.docker.com/r/rohitghumare64/kubectl-mcp-server)
657
+ - [agentregistry](https://aregistry.ai) - MCP Server Registry
561
658
  - [GitHub Issues](https://github.com/rohitg00/kubectl-mcp-server/issues)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "kubectl-mcp-server",
3
- "version": "1.10.0",
3
+ "version": "1.12.0",
4
4
  "description": "A Model Context Protocol (MCP) server for Kubernetes that enables AI assistants like Claude, Cursor, and others to interact with Kubernetes clusters through natural language",
5
5
  "keywords": [
6
6
  "kubernetes",