kubectl-mcp-server 1.16.0__tar.gz → 1.18.0__tar.gz

{kubectl_mcp_server-1.16.0 → kubectl_mcp_server-1.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kubectl-mcp-server
-Version: 1.16.0
+Version: 1.18.0
 Summary: A Model Context Protocol (MCP) server for Kubernetes with 220+ tools, 8 resources, and 8 prompts
 Home-page: https://github.com/rohitg00/kubectl-mcp-server
 Author: Rohit Ghumare
@@ -121,6 +121,7 @@ pip install kubectl-mcp-server[ui]
 - [In-Cluster Deployment](#in-cluster-deployment)
 - [Multi-Cluster Support](#multi-cluster-support)
 - [Architecture](#architecture)
+- [Agent Skills](#agent-skills-24-skills-for-ai-coding-agents)
 - [Development & Testing](#development--testing)
 - [Contributing](#contributing)
 - [Support & Community](#support--community)
@@ -875,6 +876,52 @@ kubectl_mcp_tool/
 └── cli/                    # CLI interface
 ```
 
+## Agent Skills (24 Skills for AI Coding Agents)
+
+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.
+
+### Quick Install
+
+```bash
+# Copy all skills to Claude
+cp -r kubernetes-skills/claude/* ~/.claude/skills/
+
+# Or install specific skills
+cp -r kubernetes-skills/claude/k8s-helm ~/.claude/skills/
+```
+
+### Available Skills (24)
+
+| Category | Skills |
+|----------|--------|
+| **Core Resources** | k8s-core, k8s-networking, k8s-storage |
+| **Workloads** | k8s-deploy, k8s-operations, k8s-helm |
+| **Observability** | k8s-diagnostics, k8s-troubleshoot, k8s-incident |
+| **Security** | k8s-security, k8s-policy, k8s-certs |
+| **GitOps** | k8s-gitops, k8s-rollouts |
+| **Scaling** | k8s-autoscaling, k8s-cost, k8s-backup |
+| **Multi-Cluster** | k8s-multicluster, k8s-capi, k8s-kubevirt |
+| **Networking** | k8s-service-mesh, k8s-cilium |
+| **Tools** | k8s-browser, k8s-cli |
+
+### Convert to Other Agents
+
+Use [SkillKit](https://github.com/rohitg00/skillkit) to convert skills to your preferred AI agent format:
+
+```bash
+npm install -g skillkit
+
+# Convert to Cursor format
+skillkit translate kubernetes-skills/claude --to cursor --output .cursor/rules/
+
+# Convert to Codex format
+skillkit translate kubernetes-skills/claude --to codex --output ./
+```
+
+**Supported agents:** Claude, Cursor, Codex, Gemini CLI, GitHub Copilot, Goose, Windsurf, Roo, Amp, and more.
+
+See [kubernetes-skills/README.md](kubernetes-skills/README.md) for full documentation.
+
 ## Multi-Cluster Support
 
 Seamlessly manage multiple Kubernetes clusters through natural language. **Every tool** supports an optional `context` parameter to target any cluster without switching contexts.

{kubectl_mcp_server-1.16.0 → kubectl_mcp_server-1.18.0}/README.md

@@ -63,6 +63,7 @@ pip install kubectl-mcp-server[ui]
 - [In-Cluster Deployment](#in-cluster-deployment)
 - [Multi-Cluster Support](#multi-cluster-support)
 - [Architecture](#architecture)
+- [Agent Skills](#agent-skills-24-skills-for-ai-coding-agents)
 - [Development & Testing](#development--testing)
 - [Contributing](#contributing)
 - [Support & Community](#support--community)
@@ -817,6 +818,52 @@ kubectl_mcp_tool/
 └── cli/                    # CLI interface
 ```
 
+## Agent Skills (24 Skills for AI Coding Agents)
+
+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.
+
+### Quick Install
+
+```bash
+# Copy all skills to Claude
+cp -r kubernetes-skills/claude/* ~/.claude/skills/
+
+# Or install specific skills
+cp -r kubernetes-skills/claude/k8s-helm ~/.claude/skills/
+```
+
+### Available Skills (24)
+
+| Category | Skills |
+|----------|--------|
+| **Core Resources** | k8s-core, k8s-networking, k8s-storage |
+| **Workloads** | k8s-deploy, k8s-operations, k8s-helm |
+| **Observability** | k8s-diagnostics, k8s-troubleshoot, k8s-incident |
+| **Security** | k8s-security, k8s-policy, k8s-certs |
+| **GitOps** | k8s-gitops, k8s-rollouts |
+| **Scaling** | k8s-autoscaling, k8s-cost, k8s-backup |
+| **Multi-Cluster** | k8s-multicluster, k8s-capi, k8s-kubevirt |
+| **Networking** | k8s-service-mesh, k8s-cilium |
+| **Tools** | k8s-browser, k8s-cli |
+
+### Convert to Other Agents
+
+Use [SkillKit](https://github.com/rohitg00/skillkit) to convert skills to your preferred AI agent format:
+
+```bash
+npm install -g skillkit
+
+# Convert to Cursor format
+skillkit translate kubernetes-skills/claude --to cursor --output .cursor/rules/
+
+# Convert to Codex format
+skillkit translate kubernetes-skills/claude --to codex --output ./
+```
+
+**Supported agents:** Claude, Cursor, Codex, Gemini CLI, GitHub Copilot, Goose, Windsurf, Roo, Amp, and more.
+
+See [kubernetes-skills/README.md](kubernetes-skills/README.md) for full documentation.
+
 ## Multi-Cluster Support
 
 Seamlessly manage multiple Kubernetes clusters through natural language. **Every tool** supports an optional `context` parameter to target any cluster without switching contexts.

{kubectl_mcp_server-1.16.0 → kubectl_mcp_server-1.18.0}/kubectl_mcp_server.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kubectl-mcp-server
-Version: 1.16.0
+Version: 1.18.0
 Summary: A Model Context Protocol (MCP) server for Kubernetes with 220+ tools, 8 resources, and 8 prompts
 Home-page: https://github.com/rohitg00/kubectl-mcp-server
 Author: Rohit Ghumare
@@ -121,6 +121,7 @@ pip install kubectl-mcp-server[ui]
 - [In-Cluster Deployment](#in-cluster-deployment)
 - [Multi-Cluster Support](#multi-cluster-support)
 - [Architecture](#architecture)
+- [Agent Skills](#agent-skills-24-skills-for-ai-coding-agents)
 - [Development & Testing](#development--testing)
 - [Contributing](#contributing)
 - [Support & Community](#support--community)
@@ -875,6 +876,52 @@ kubectl_mcp_tool/
 └── cli/                    # CLI interface
 ```
 
+## Agent Skills (24 Skills for AI Coding Agents)
+
+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.
+
+### Quick Install
+
+```bash
+# Copy all skills to Claude
+cp -r kubernetes-skills/claude/* ~/.claude/skills/
+
+# Or install specific skills
+cp -r kubernetes-skills/claude/k8s-helm ~/.claude/skills/
+```
+
+### Available Skills (24)
+
+| Category | Skills |
+|----------|--------|
+| **Core Resources** | k8s-core, k8s-networking, k8s-storage |
+| **Workloads** | k8s-deploy, k8s-operations, k8s-helm |
+| **Observability** | k8s-diagnostics, k8s-troubleshoot, k8s-incident |
+| **Security** | k8s-security, k8s-policy, k8s-certs |
+| **GitOps** | k8s-gitops, k8s-rollouts |
+| **Scaling** | k8s-autoscaling, k8s-cost, k8s-backup |
+| **Multi-Cluster** | k8s-multicluster, k8s-capi, k8s-kubevirt |
+| **Networking** | k8s-service-mesh, k8s-cilium |
+| **Tools** | k8s-browser, k8s-cli |
+
+### Convert to Other Agents
+
+Use [SkillKit](https://github.com/rohitg00/skillkit) to convert skills to your preferred AI agent format:
+
+```bash
+npm install -g skillkit
+
+# Convert to Cursor format
+skillkit translate kubernetes-skills/claude --to cursor --output .cursor/rules/
+
+# Convert to Codex format
+skillkit translate kubernetes-skills/claude --to codex --output ./
+```
+
+**Supported agents:** Claude, Cursor, Codex, Gemini CLI, GitHub Copilot, Goose, Windsurf, Roo, Amp, and more.
+
+See [kubernetes-skills/README.md](kubernetes-skills/README.md) for full documentation.
+
 ## Multi-Cluster Support
 
 Seamlessly manage multiple Kubernetes clusters through natural language. **Every tool** supports an optional `context` parameter to target any cluster without switching contexts.

{kubectl_mcp_server-1.16.0 → kubectl_mcp_server-1.18.0}/kubectl_mcp_server.egg-info/SOURCES.txt

@@ -13,6 +13,8 @@ kubectl_mcp_tool/crd_detector.py
 kubectl_mcp_tool/diagnostics.py
 kubectl_mcp_tool/k8s_config.py
 kubectl_mcp_tool/mcp_server.py
+kubectl_mcp_tool/providers.py
+kubectl_mcp_tool/safety.py
 kubectl_mcp_tool/auth/__init__.py
 kubectl_mcp_tool/auth/config.py
 kubectl_mcp_tool/auth/scopes.py
@@ -22,7 +24,16 @@ kubectl_mcp_tool/cli/__main__.py
 kubectl_mcp_tool/cli/cli.py
 kubectl_mcp_tool/cli/errors.py
 kubectl_mcp_tool/cli/output.py
+kubectl_mcp_tool/config/__init__.py
+kubectl_mcp_tool/config/loader.py
+kubectl_mcp_tool/config/schema.py
+kubectl_mcp_tool/observability/__init__.py
+kubectl_mcp_tool/observability/metrics.py
+kubectl_mcp_tool/observability/stats.py
+kubectl_mcp_tool/observability/tracing.py
 kubectl_mcp_tool/prompts/__init__.py
+kubectl_mcp_tool/prompts/builtin.py
+kubectl_mcp_tool/prompts/custom.py
 kubectl_mcp_tool/prompts/prompts.py
 kubectl_mcp_tool/resources/__init__.py
 kubectl_mcp_tool/resources/resources.py
@@ -57,8 +68,12 @@ tests/conftest.py
 tests/test_auth.py
 tests/test_browser.py
 tests/test_cli.py
+tests/test_config.py
 tests/test_ecosystem.py
+tests/test_mcp_integration.py
+tests/test_observability.py
 tests/test_prompts.py
 tests/test_resources.py
+tests/test_safety.py
 tests/test_server.py
 tests/test_tools.py

{kubectl_mcp_server-1.16.0 → kubectl_mcp_server-1.18.0}/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.16.0"
+__version__ = "1.18.0"
 
 from .mcp_server import MCPServer
 from .diagnostics import run_diagnostics, check_kubectl_installation, check_cluster_connection

{kubectl_mcp_server-1.16.0 → kubectl_mcp_server-1.18.0}/kubectl_mcp_tool/cli/cli.py

@@ -37,6 +37,7 @@ from .output import (
     format_error,
     format_success,
 )
+from ..safety import SafetyMode, set_safety_mode, get_mode_info
 
 # Logging setup
 log_file = os.environ.get("MCP_LOG_FILE")
@@ -56,18 +57,49 @@ logging.basicConfig(
 logger = logging.getLogger("kubectl-mcp-cli")
 
 
-async def serve_stdio():
-    server = MCPServer("kubernetes")
+async def serve_stdio(
+    read_only: bool = False,
+    disable_destructive: bool = False,
+    config_file: Optional[str] = None,
+):
+    server = MCPServer(
+        "kubernetes",
+        read_only=read_only,
+        disable_destructive=disable_destructive,
+        config_file=config_file,
+    )
     await server.serve_stdio()
 
 
-async def serve_sse(host: str, port: int):
-    server = MCPServer("kubernetes")
+async def serve_sse(
+    host: str,
+    port: int,
+    read_only: bool = False,
+    disable_destructive: bool = False,
+    config_file: Optional[str] = None,
+):
+    server = MCPServer(
+        "kubernetes",
+        read_only=read_only,
+        disable_destructive=disable_destructive,
+        config_file=config_file,
+    )
     await server.serve_sse(host=host, port=port)
 
 
-async def serve_http(host: str, port: int):
-    server = MCPServer("kubernetes")
+async def serve_http(
+    host: str,
+    port: int,
+    read_only: bool = False,
+    disable_destructive: bool = False,
+    config_file: Optional[str] = None,
+):
+    server = MCPServer(
+        "kubernetes",
+        read_only=read_only,
+        disable_destructive=disable_destructive,
+        config_file=config_file,
+    )
     await server.serve_http(host=host, port=port)
 
 
@@ -282,12 +314,16 @@ def cmd_info(args):
     except Exception:
         pass
 
+    # Get safety mode info
+    mode_info = get_mode_info()
+
     print(format_server_info(
         version=__version__,
         tool_count=len(tools),
         resource_count=len(resources),
         prompt_count=len(prompts),
         context=context,
+        safety_mode=mode_info,
         as_json=getattr(args, 'json', False)
     ))
     return ErrorCode.SUCCESS
@@ -407,6 +443,16 @@ def cmd_doctor(args):
     except ImportError:
         checks.append({"name": "fastmcp", "status": "error", "details": "fastmcp not installed"})
 
+    # Check safety mode
+    mode_info = get_mode_info()
+    mode = mode_info.get("mode", "normal")
+    if mode == "normal":
+        checks.append({"name": "safety_mode", "status": "ok", "version": mode, "details": "All operations allowed"})
+    elif mode == "read_only":
+        checks.append({"name": "safety_mode", "status": "warning", "version": mode, "details": "Write operations blocked"})
+    else:
+        checks.append({"name": "safety_mode", "status": "warning", "version": mode, "details": "Destructive operations blocked"})
+
     print(format_doctor_results(checks, as_json=getattr(args, 'json', False)))
 
     # Return error code if any critical checks failed
@@ -453,6 +499,9 @@ Environment Variables:
     )
     serve_parser.add_argument("--host", type=str, default="0.0.0.0", help="Host for SSE/HTTP (default: 0.0.0.0)")
     serve_parser.add_argument("--port", type=int, default=8000, help="Port for SSE/HTTP (default: 8000)")
+    serve_parser.add_argument("--config", type=str, default=None, help="Path to TOML configuration file")
+    serve_parser.add_argument("--read-only", action="store_true", help="Enable read-only mode (block all write operations)")
+    serve_parser.add_argument("--disable-destructive", action="store_true", help="Disable destructive operations (allow create/update, block delete)")
 
     # version command (existing)
     subparsers.add_parser("version", help="Show version")
@@ -507,12 +556,37 @@ Environment Variables:
 
     try:
         if args.command == "serve":
+            # Log safety mode (actual mode is applied in MCPServer)
+            if args.read_only:
+                logger.info("Starting server in READ-ONLY mode")
+            elif args.disable_destructive:
+                logger.info("Starting server with destructive operations disabled")
+
+            if args.config:
+                logger.info(f"Loading configuration from: {args.config}")
+
             if args.transport == "stdio":
-                asyncio.run(serve_stdio())
+                asyncio.run(serve_stdio(
+                    read_only=args.read_only,
+                    disable_destructive=args.disable_destructive,
+                    config_file=args.config,
+                ))
             elif args.transport == "sse":
-                asyncio.run(serve_sse(args.host, args.port))
+                asyncio.run(serve_sse(
+                    host=args.host,
+                    port=args.port,
+                    read_only=args.read_only,
+                    disable_destructive=args.disable_destructive,
+                    config_file=args.config,
+                ))
             elif args.transport in ("http", "streamable-http"):
-                asyncio.run(serve_http(args.host, args.port))
+                asyncio.run(serve_http(
+                    host=args.host,
+                    port=args.port,
+                    read_only=args.read_only,
+                    disable_destructive=args.disable_destructive,
+                    config_file=args.config,
+                ))
 
         elif args.command == "version":
             from .. import __version__

{kubectl_mcp_server-1.16.0 → kubectl_mcp_server-1.18.0}/kubectl_mcp_tool/cli/output.py

@@ -266,6 +266,7 @@ def format_server_info(
     resource_count: int,
     prompt_count: int,
     context: Optional[str] = None,
+    safety_mode: Optional[Dict[str, Any]] = None,
     as_json: bool = False
 ) -> str:
     info = {
@@ -276,6 +277,9 @@ def format_server_info(
         "k8s_context": context,
     }
 
+    if safety_mode:
+        info["safety_mode"] = safety_mode
+
     if as_json:
         return json.dumps(info, indent=2)
 
@@ -291,6 +295,16 @@ def format_server_info(
     if context:
         lines.append(f"  {cyan('K8s Context:')} {context}")
 
+    if safety_mode:
+        mode = safety_mode.get("mode", "normal")
+        if mode == "normal":
+            mode_str = green(mode)
+        elif mode == "read_only":
+            mode_str = yellow(mode) + " (write operations blocked)"
+        else:
+            mode_str = yellow(mode) + " (destructive operations blocked)"
+        lines.append(f"  {cyan('Safety Mode:')} {mode_str}")
+
     return "\n".join(lines)
 
 

kubectl_mcp_server-1.18.0/kubectl_mcp_tool/config/__init__.py

@@ -0,0 +1,46 @@
+"""Configuration management for kubectl-mcp-server.
+
+This module provides TOML-based configuration with:
+- Main config file support
+- Drop-in directory for modular configuration
+- SIGHUP reload for runtime updates
+- Environment variable overrides
+"""
+
+from .loader import (
+    Config,
+    load_config,
+    get_config,
+    reload_config,
+    get_config_paths,
+    setup_sighup_handler,
+    register_reload_callback,
+    unregister_reload_callback,
+)
+from .schema import (
+    ServerConfig,
+    SafetyConfig,
+    BrowserConfig,
+    MetricsConfig,
+    LoggingConfig,
+    validate_config,
+)
+
+__all__ = [
+    # Config loading
+    "Config",
+    "load_config",
+    "get_config",
+    "reload_config",
+    "get_config_paths",
+    "setup_sighup_handler",
+    "register_reload_callback",
+    "unregister_reload_callback",
+    # Config schemas
+    "ServerConfig",
+    "SafetyConfig",
+    "BrowserConfig",
+    "MetricsConfig",
+    "LoggingConfig",
+    "validate_config",
+]