kubectl-mcp-server 1.12.0__py3-none-any.whl → 1.13.0__py3-none-any.whl

{kubectl_mcp_server-1.12.0.dist-info → kubectl_mcp_server-1.13.0.dist-info}/METADATA

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: kubectl-mcp-server
-Version: 1.12.0
-Summary: A Model Context Protocol (MCP) server for Kubernetes with 121+ tools, 8 resources, and 8 prompts
+Version: 1.13.0
+Summary: A Model Context Protocol (MCP) server for Kubernetes with 127+ tools, 8 resources, and 8 prompts
 Home-page: https://github.com/rohitg00/kubectl-mcp-server
 Author: Rohit Ghumare
 Author-email: ghumare64@gmail.com
 Project-URL: Bug Tracker, https://github.com/rohitg00/kubectl-mcp-server/issues
 Project-URL: Documentation, https://github.com/rohitg00/kubectl-mcp-server#readme
 Project-URL: Source, https://github.com/rohitg00/kubectl-mcp-server
-Keywords: kubernetes,mcp,model-context-protocol,kubectl,helm,ai-assistant,claude,cursor,windsurf,fastmcp,devops,cloud-native
+Keywords: kubernetes,mcp,model-context-protocol,kubectl,helm,ai-assistant,claude,cursor,windsurf,fastmcp,devops,cloud-native,mcp-ui
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
@@ -38,6 +38,10 @@ Requires-Dist: cryptography>=42.0.2
 Requires-Dist: rich>=13.0.0
 Requires-Dist: aiohttp>=3.8.0
 Requires-Dist: aiohttp-sse>=2.1.0
+Provides-Extra: ui
+Requires-Dist: mcp-ui-server>=0.5.0; extra == "ui"
+Provides-Extra: all
+Requires-Dist: mcp-ui-server>=0.5.0; extra == "all"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -47,6 +51,7 @@ Dynamic: home-page
 Dynamic: keywords
 Dynamic: license-file
 Dynamic: project-url
+Dynamic: provides-extra
 Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
@@ -95,7 +100,7 @@ Works with all MCP-compatible AI assistants:
 
 ## Features
 
-### 121 MCP Tools for Complete Kubernetes Management
+### 127 MCP Tools for Complete Kubernetes Management
 
 | Category | Tools |
 |----------|-------|
@@ -119,6 +124,7 @@ Works with all MCP-compatible AI assistants:
 | **Autoscaling** | `get_hpa`, `get_pdb` |
 | **Cost Optimization** | `get_resource_recommendations`, `get_idle_resources`, `get_resource_quotas_usage`, `get_cost_analysis`, `get_overprovisioned_resources`, `get_resource_trends`, `get_namespace_cost_allocation`, `optimize_resource_requests` |
 | **Advanced** | `kubectl_generic`, `kubectl_explain`, `get_api_resources`, `port_forward`, `get_resource_usage`, `node_management` |
+| **UI Dashboards** | `show_pod_logs_ui`, `show_pods_dashboard_ui`, `show_resource_yaml_ui`, `show_cluster_overview_ui`, `show_events_timeline_ui`, `render_k8s_dashboard_screenshot` |
 
 ### MCP Resources (FastMCP 3)
 
@@ -166,6 +172,7 @@ Pre-built workflow prompts for common Kubernetes operations:
 - **Helm v3**: Full Helm chart lifecycle management
 - **Cost Optimization**: Resource recommendations, idle resource detection, usage analysis
 - **FastMCP 3**: MCP Resources and Prompts for enhanced AI workflows
+- **MCP-UI Support**: Interactive HTML dashboards for compatible hosts (Goose, LibreChat)
 
 ## Installation
 
@@ -189,6 +196,9 @@ npm install -g kubectl-mcp-server
 ```bash
 pip install kubectl-mcp-server
 
+# With MCP-UI support (interactive dashboards)
+pip install kubectl-mcp-server[ui]
+
 # Legacy alias (still works for backward compatibility)
 pip install kubectl-mcp-tool
 ```
@@ -389,6 +399,46 @@ python -m kubectl_mcp_tool.mcp_server --transport http --port 8000
 |----------|-------------|
 | `MCP_BROWSER_ENABLED` | Enable browser automation tools (default: `false`) |
 
+## MCP-UI Tools (Interactive Dashboards)
+
+Enable rich HTML dashboards in MCP-UI compatible hosts (Goose, LibreChat, Nanobot).
+
+### Installation
+
+```bash
+# Install with MCP-UI support
+pip install kubectl-mcp-server[ui]
+```
+
+### 6 UI Dashboard Tools
+
+| Tool | Description |
+|------|-------------|
+| `show_pod_logs_ui` | Interactive log viewer with search and filtering |
+| `show_pods_dashboard_ui` | Pods table with status, restarts, and filtering |
+| `show_resource_yaml_ui` | YAML viewer with syntax highlighting |
+| `show_cluster_overview_ui` | Cluster dashboard with nodes, namespaces, workloads |
+| `show_events_timeline_ui` | Events timeline with severity filtering |
+| `render_k8s_dashboard_screenshot` | Render any dashboard as PNG screenshot |
+
+### Features
+
+- **Dark theme**: Catppuccin-style dark UI optimized for terminals
+- **Graceful fallback**: Returns JSON data if MCP-UI not supported
+- **Screenshot rendering**: Works with agent-browser for universal compatibility
+- **No external dependencies**: Pure HTML/CSS/JS dashboards
+
+### Compatibility
+
+| Host | MCP-UI Support | Fallback |
+|------|----------------|----------|
+| Goose | ✅ Full | - |
+| LibreChat | ✅ Full | - |
+| Nanobot | ✅ Full | - |
+| Claude Desktop | ❌ | JSON + Screenshot |
+| Cursor | ❌ | JSON + Screenshot |
+| Other MCP Clients | ❌ | JSON + Screenshot |
+
 ## Browser Tools (Optional Module)
 
 Enable browser automation for web-based K8s operations using [agent-browser](https://github.com/vercel-labs/agent-browser).
@@ -493,16 +543,35 @@ arctl mcp install io.github.rohitg00/kubectl-mcp-server
 
 ### agentgateway Integration
 
-Use with [agentgateway](https://github.com/agentgateway/agentgateway) for unified MCP routing:
+Use with [agentgateway](https://github.com/agentgateway/agentgateway) for unified MCP routing to multiple MCP servers.
 
 ```bash
-# Install agentgateway
-cargo install agentgateway
+# Start kubectl-mcp-server with streamable-http transport
+kubectl-mcp-server --transport streamable-http --port 8000
+```
 
-# Configure kubectl-mcp-server as upstream
+Create `gateway.yaml`:
+
+```yaml
+binds:
+- port: 3000
+  listeners:
+  - routes:
+    - backends:
+      - mcp:
+          targets:
+          - name: kubectl-mcp-server
+            mcp:
+              host: http://localhost:8000/mcp
+```
+
+```bash
+# Run agentgateway
 agentgateway --config gateway.yaml
 ```
 
+Connect MCP clients to `http://localhost:3000/mcp`. All 127 tools are discoverable through the gateway.
+
 ## Kubernetes Deployment
 
 Deploy kubectl-mcp-server directly in your Kubernetes cluster for centralized access.
@@ -569,7 +638,7 @@ See [deploy/](deploy/) for full manifests and configuration options.
 
 ### kagent Integration (AI Agents)
 
-[kagent](https://github.com/kagent-dev/kagent) is a Kubernetes-native AI agent framework (CNCF project). Register kubectl-mcp-server as a ToolServer to give your agents 121 K8s management tools.
+[kagent](https://github.com/kagent-dev/kagent) is a Kubernetes-native AI agent framework (CNCF project). Register kubectl-mcp-server as a ToolServer to give your agents 127 K8s management tools.
 
 ```bash
 # Install kagent
@@ -601,7 +670,7 @@ The MCP server implements the [Model Context Protocol](https://github.com/modelc
 ```
 kubectl_mcp_tool/
 ├── mcp_server.py          # Main server (FastMCP, transports)
-├── tools/                  # 121 MCP tools organized by category
+├── tools/                  # 127 MCP tools organized by category
 │   ├── pods.py            # Pod management & diagnostics
 │   ├── deployments.py     # Deployments, StatefulSets, DaemonSets
 │   ├── core.py            # Namespaces, ConfigMaps, Secrets
@@ -612,7 +681,8 @@ kubectl_mcp_tool/
 │   ├── helm.py            # Complete Helm v3 operations
 │   ├── operations.py      # kubectl apply/patch/describe/etc
 │   ├── diagnostics.py     # Metrics, namespace comparison
-│   └── cost.py            # Resource optimization & cost analysis
+│   ├── cost.py            # Resource optimization & cost analysis
+│   └── ui.py              # MCP-UI interactive dashboards
 ├── resources/              # 8 MCP Resources for data exposure
 ├── prompts/                # 8 MCP Prompts for workflows
 └── cli/                    # CLI interface
@@ -707,5 +777,4 @@ MIT License - see [LICENSE](LICENSE) for details.
 - [PyPI Package](https://pypi.org/project/kubectl-mcp-server/)
 - [npm Package](https://www.npmjs.com/package/kubectl-mcp-server)
 - [Docker Hub](https://hub.docker.com/r/rohitghumare64/kubectl-mcp-server)
-- [agentregistry](https://aregistry.ai) - MCP Server Registry
 - [GitHub Issues](https://github.com/rohitg00/kubectl-mcp-server/issues)

{kubectl_mcp_server-1.12.0.dist-info → kubectl_mcp_server-1.13.0.dist-info}/RECORD

@@ -1,9 +1,9 @@
-kubectl_mcp_server-1.12.0.dist-info/licenses/LICENSE,sha256=nH9Z0W0WNH2oQ4cPrBAU8ldDcHfeI6NUbkSGiazYWgQ,1070
-kubectl_mcp_tool/__init__.py,sha256=Z_IyVF0iPum8NzMC_5yXS1P_1vwrW9yQUalEfCEjjzs,580
+kubectl_mcp_server-1.13.0.dist-info/licenses/LICENSE,sha256=nH9Z0W0WNH2oQ4cPrBAU8ldDcHfeI6NUbkSGiazYWgQ,1070
+kubectl_mcp_tool/__init__.py,sha256=vSKEsUXD6nvbpSu2otStmS9W2mKfF07Yj7WE1lyY-N8,580
 kubectl_mcp_tool/__main__.py,sha256=CE6cTD6PA71Ap0i5_gE17Pb9FcedOJmtGRNzZ5-TFSc,1490
 kubectl_mcp_tool/diagnostics.py,sha256=uwolSoHadRkB-J8PAsabbexfj6sTNCIIRRrABBRXoTU,11776
 kubectl_mcp_tool/k8s_config.py,sha256=StM6Bb1SAVbFgNg5wKRmb_9aQ1wxEHtriCTIjvEFc5U,7853
-kubectl_mcp_tool/mcp_server.py,sha256=OUrW04BRVpmsr1-8NDTjC1vaJ0VQCbjkcXkavy9lzVs,20927
+kubectl_mcp_tool/mcp_server.py,sha256=T1ZQWw9c69VDM11ECxavTc6NYWcjy4q1FpkqW23fiwc,21309
 kubectl_mcp_tool/auth/__init__.py,sha256=ot8ivZZkDtV8Rg0y1UYruwobKCPyxX1svqh35wWxKvY,347
 kubectl_mcp_tool/auth/config.py,sha256=wi3wuJNMyDqMeluDHL0MaJyedIFv5CFVxiUaEVaTvzk,2267
 kubectl_mcp_tool/auth/scopes.py,sha256=KPmuGO0SrTkjzlElWFOV29ie9apTdMklOCkiA-965lI,6147
@@ -15,7 +15,7 @@ kubectl_mcp_tool/prompts/__init__.py,sha256=BacBNfoVxow6aci8Zzcfam3m1oM7yYzM0IRT
 kubectl_mcp_tool/prompts/prompts.py,sha256=ZfmTCio8NqOYYxF8VVo9f6VWGCS34J8tvmBfhNblr58,22942
 kubectl_mcp_tool/resources/__init__.py,sha256=ERkn0ErlaGi9-dybv4wrAaT8WretvNp6K002h7Agjno,83
 kubectl_mcp_tool/resources/resources.py,sha256=kvK4OM3Ox5cFvWDqJBTXOfBgnRYdoqdvvjsdCg0PJfY,12713
-kubectl_mcp_tool/tools/__init__.py,sha256=mlvnz6P99jKwj6S8NJuX9UyaOLU1ARa5-CCkcc-3ju0,958
+kubectl_mcp_tool/tools/__init__.py,sha256=tlm6TtwzHbGqQhIAQNAByLjgpDiim3eqdP89Y3JZfiA,1057
 kubectl_mcp_tool/tools/browser.py,sha256=PDT7Uj7CCBQI9CFAaMSM_3i6v3NXIAf-mwd1y7iESa8,15193
 kubectl_mcp_tool/tools/cluster.py,sha256=qQh6bET3-KQ8nkB2GnB8A7gohbJLrx6_K11TPYR6AII,11956
 kubectl_mcp_tool/tools/core.py,sha256=zL0bGCxPGocH34ueZlSsBVsNp_tUL0C2gqyjlJljMXY,15009
@@ -28,18 +28,19 @@ kubectl_mcp_tool/tools/operations.py,sha256=egYhlmqVZygddCkDJ2GDr89EjApps_PssWra
 kubectl_mcp_tool/tools/pods.py,sha256=7Ezk9khxoKsJYw8xEyBMjFdpLXmisGGrnKVVJ3rbhLE,23801
 kubectl_mcp_tool/tools/security.py,sha256=Tu5SFPoeSgXkoc7WEpnnmdrMDJaB5znDoIVyyAy1Rho,12550
 kubectl_mcp_tool/tools/storage.py,sha256=lXWp7131P39eTAsaMFrrJbWPuOGfDolVbD6npTBy1eQ,5124
+kubectl_mcp_tool/tools/ui.py,sha256=HHi0KM2JTvZFpQjo5V6XkJf02hxFoasec7uyNY5wuuo,39702
 kubectl_mcp_tool/utils/__init__.py,sha256=CHBCpaXwt994DlqyRFkkRky2TK8OmmDl0Gyc28369gI,348
 kubectl_mcp_tool/utils/helpers.py,sha256=W--wiVSKKqmjpxxdLT0J6rmhOQcp1OFk9jLrtQUVpGw,2444
 tests/__init__.py,sha256=qZPXYXv3whkkWhi61Ngzj09GHnIFlVSZrajE0XRk55o,290
 tests/conftest.py,sha256=6054YlpuGleV3Wg8BnVj4lnKWhGk-Eqc9JYTXxOmsXs,10782
 tests/test_auth.py,sha256=PoESfWiN92wSGUdVwLL3Z1AP6C1zUsVmgTI7Q8ZdlxM,11074
-tests/test_browser.py,sha256=Oav6N4ivr_DW9038bVl31eAACt6vQORTr0uRgfeLs9A,14074
+tests/test_browser.py,sha256=kgkcsTzOtToCpkmoG2w8iLCpW1xKrYqXjdGjF8UmwoY,14074
 tests/test_prompts.py,sha256=3TcJUvSNxhTqfySW6DCrW9MwiMDumciLQRjjbucwqlA,17803
 tests/test_resources.py,sha256=Z0Ex8WdRz-B3VZa1s0eAaDDGbhy7dRdqy1uFVOe2Qbo,12689
 tests/test_server.py,sha256=lLvgbqutnivSgQMNrki0O48whBQt0UXjdwT047nf0nw,14415
-tests/test_tools.py,sha256=MYJn8YlZIg2boX0OGTXyONRuA3M7vYZEATkwSVsya0c,30241
-kubectl_mcp_server-1.12.0.dist-info/METADATA,sha256=Czr2PxQzTXEnV2Lc0d4d-wezu5rDBkSj_Fry1pajS_Q,23715
-kubectl_mcp_server-1.12.0.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-kubectl_mcp_server-1.12.0.dist-info/entry_points.txt,sha256=zeOxQGaNC4r58deEmqsLCU5hfMjF0VqFUt9P5wWsKEM,109
-kubectl_mcp_server-1.12.0.dist-info/top_level.txt,sha256=o5IpfOGG-lqU8rVWJeK9aYC0r4f6qEX09QiBhZlYbkQ,23
-kubectl_mcp_server-1.12.0.dist-info/RECORD,,
+tests/test_tools.py,sha256=bQMcVrXvWh1PpchcEI1aMkIFXlHmF_trJDI3Lg8kKIk,30516
+kubectl_mcp_server-1.13.0.dist-info/METADATA,sha256=v_5xuIS0PK1G2iQ1RAHBJMTkdt3FcKuC81hejJlzV7k,26011
+kubectl_mcp_server-1.13.0.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+kubectl_mcp_server-1.13.0.dist-info/entry_points.txt,sha256=zeOxQGaNC4r58deEmqsLCU5hfMjF0VqFUt9P5wWsKEM,109
+kubectl_mcp_server-1.13.0.dist-info/top_level.txt,sha256=o5IpfOGG-lqU8rVWJeK9aYC0r4f6qEX09QiBhZlYbkQ,23
+kubectl_mcp_server-1.13.0.dist-info/RECORD,,

kubectl_mcp_tool/__init__.py

@@ -7,7 +7,7 @@ with Kubernetes clusters through natural language commands.
 For more information, see: https://github.com/rohitg00/kubectl-mcp-server
 """
 
-__version__ = "1.12.0"
+__version__ = "1.13.0"
 
 from .mcp_server import MCPServer
 from .diagnostics import run_diagnostics, check_kubectl_installation, check_cluster_connection

kubectl_mcp_tool/mcp_server.py

@@ -43,6 +43,8 @@ from kubectl_mcp_tool.tools import (
     register_cost_tools,
     register_browser_tools,
     is_browser_available,
+    register_ui_tools,
+    is_ui_available,
 )
 from kubectl_mcp_tool.resources import register_resources
 from kubectl_mcp_tool.prompts import register_prompts
@@ -187,6 +189,13 @@ class MCPServer:
         else:
             logger.debug("Browser tools disabled (set MCP_BROWSER_ENABLED=true to enable)")
 
+        # Register MCP-UI tools for interactive dashboards (optional)
+        if is_ui_available():
+            register_ui_tools(self.server, self.non_destructive)
+            logger.info("MCP-UI tools enabled (mcp-ui-server installed)")
+        else:
+            logger.debug("MCP-UI tools disabled (install mcp-ui-server to enable)")
+
     def setup_resources(self):
         """Set up MCP resources for Kubernetes data exposure."""
         register_resources(self.server)

kubectl_mcp_tool/tools/__init__.py

@@ -10,6 +10,7 @@ from .operations import register_operations_tools
 from .diagnostics import register_diagnostics_tools
 from .cost import register_cost_tools
 from .browser import register_browser_tools, is_browser_available
+from .ui import register_ui_tools, is_ui_available
 
 __all__ = [
     "register_helm_tools",
@@ -25,4 +26,6 @@ __all__ = [
     "register_cost_tools",
     "register_browser_tools",
     "is_browser_available",
+    "register_ui_tools",
+    "is_ui_available",
 ]