feat: redesign setup and add missed unittest for cli package (#13)

Author: Agent-Hellboy

.github/workflows/post-merge.yaml

@@ -75,7 +75,7 @@ jobs:
       - name: Run unit tests with coverage
         run: |
           go test -v -race -coverprofile=unit.out \
-            $(go list ./... | grep -v '^mcp-runtime/test' | grep -v '^mcp-runtime/examples/example-app$')
+            $(go list ./... | grep -v '^github.com/Agent-Hellboy/mcp-runtime/test' | grep -v '^github.com/Agent-Hellboy/mcp-runtime/examples/example-app$')
 
       - name: Run integration tests with coverage
         run: |

.github/workflows/pre-check.yaml

@@ -58,7 +58,7 @@ jobs:
       - name: Run unit tests with coverage
         run: |
           go test -v -race -coverprofile=unit.out \
-            $(go list ./... | grep -v '^mcp-runtime/test' | grep -v '^mcp-runtime/examples/example-app$')
+            $(go list ./... | grep -v '^github.com/Agent-Hellboy/mcp-runtime/test' | grep -v '^github.com/Agent-Hellboy/mcp-runtime/examples/example-app$')
 
       - name: Run integration tests with coverage
         run: |

.gitignore

@@ -11,3 +11,6 @@ benchmarking.md
 .fakehome/
 .cache/
 DIFF*.md
+.gomodcache/
+FUTURE_PLAN.md
+.DS_Store

.pre-commit-config.yaml

@@ -8,12 +8,10 @@ repos:
         types: [go]
       - id: staticcheck
         name: staticcheck
-        entry: staticcheck
-        language: golang
+        entry: hack/staticcheck.sh
+        language: system
         pass_filenames: false
         args: [./...]
-        additional_dependencies:
-          - honnef.co/go/tools/cmd/staticcheck@latest
       - id: govet
         name: go vet
         entry: go vet ./...

Dockerfile.operator

@@ -1,4 +1,4 @@
-FROM golang:1.23-alpine AS builder
+FROM golang:1.24.11-alpine AS builder
 
 WORKDIR /build
 

README.md

@@ -3,7 +3,7 @@
 [![Post-Merge Checks](https://github.com/Agent-Hellboy/mcp-runtime/actions/workflows/post-merge.yaml/badge.svg)](https://github.com/Agent-Hellboy/mcp-runtime/actions/workflows/post-merge.yaml)
 [![Gosec Scan](https://img.shields.io/github/actions/workflow/status/Agent-Hellboy/mcp-runtime/post-merge.yaml?branch=main&label=Gosec%20Scan)](https://github.com/Agent-Hellboy/mcp-runtime/actions/workflows/post-merge.yaml)
 [![Trivy Scan](https://img.shields.io/github/actions/workflow/status/Agent-Hellboy/mcp-runtime/post-merge.yaml?branch=main&label=Trivy%20Scan)](https://github.com/Agent-Hellboy/mcp-runtime/actions/workflows/post-merge.yaml)
-[![Coverage](https://codecov.io/gh/Agent-Hellboy/mcp-runtime/branch/main/graph/badge.svg)](https://codecov.io/gh/Agent-Hellboy/mcp-runtime)
+[![Coverage](https://codecov.io/gh/Agent-Hellboy/mcp-runtime/branch/main/graph/badge.svg)](https://codecov.io/gh/Agent-Hellboy/mcp-runtime/branch/main)
 [![Go Report Card](https://goreportcard.com/badge/github.com/Agent-Hellboy/mcp-runtime)](https://goreportcard.com/report/github.com/Agent-Hellboy/mcp-runtime)
 
 A complete platform for deploying and managing MCP (Model Context Protocol) servers. 
@@ -25,13 +25,13 @@ MCP Runtime Platform provides a streamlined workflow for teams to deploy a suite
 ## Features
 
 - **Complete Platform** - Internal registry deployment plus cluster setup helpers
-- **CLI Tool** - Manage platform, registry, cluster, and servers
+- **CLI Tool** - Manage platform, registry, cluster, certificate, pipeline, and servers
 - **Automated Setup** - One-command platform deployment
 - **CI/CD Integration** - Automated build and deployment pipeline
 - **Kubernetes Operator** - Automatically creates Deployment, Service, and Ingress
 - **Metadata-Driven** - Simple YAML files, no Kubernetes knowledge needed
 - **Unified URLs** - All servers get consistent `/{server-name}/mcp` routes
-- **Auto Image Building** - Builds from Dockerfiles and updates metadata automatically
+- **Auto Image Building** - Builds from Dockerfiles (through server build cmd) and updates metadata automatically
 
 ## Architecture
 
@@ -66,11 +66,16 @@ MCP Runtime Platform provides a streamlined workflow for teams to deploy a suite
 
 ### Required
 
-- Go 1.21+
+- Go 1.24+ (Tested on 1.24.11)
 - Make
-- kubectl (configured for your cluster)
+- kubectl (Tested on)
+```
+kubectl version
+Client Version: v1.34.1
+Kustomize Version: v5.7.1
+Server Version: v1.34.0
+```
 - Docker
-- Kubernetes cluster (1.21+) with default StorageClass
 
 
 ### Registry
@@ -125,6 +130,10 @@ Override any defaults in your server metadata if needed.
 
 ### Environment Variables
 
+#### CLI Environment Variables
+
+These variables control the behavior of the `mcp-runtime` CLI tool:
+
 | Variable | Default | Description |
 |----------|---------|-------------|
 | `MCP_DEPLOYMENT_TIMEOUT` | `5m` | Timeout for deployment readiness checks |
@@ -133,6 +142,24 @@ Override any defaults in your server metadata if needed.
 | `MCP_SKOPEO_IMAGE` | `quay.io/skopeo/stable:v1.14` | Skopeo image for in-cluster image transfers (useful for air-gapped environments) |
 | `MCP_OPERATOR_IMAGE` | (auto) | Override operator image (bypasses build/push) |
 | `MCP_DEFAULT_SERVER_PORT` | `8088` | Default container port for MCP servers |
+| `PROVISIONED_REGISTRY_URL` | (none) | URL of external/provisioned registry (used by CLI for registry operations) |
+| `PROVISIONED_REGISTRY_USERNAME` | (none) | Username for external registry authentication |
+| `PROVISIONED_REGISTRY_PASSWORD` | (none) | Password for external registry authentication |
+
+#### Operator Environment Variables
+
+These variables are set in the operator deployment and control operator behavior:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MCP_DEFAULT_INGRESS_HOST` | (none) | Default hostname for ingress resources (used when `spec.ingressHost` is not set) |
+| `DEFAULT_INGRESS_HOST` | (none) | Alternative name for default ingress host (same as `MCP_DEFAULT_INGRESS_HOST`) |
+| `DEFAULT_INGRESS_CLASS` | `traefik` | Default ingress class to use for ingress resources |
+| `PROVISIONED_REGISTRY_URL` | (none) | URL of provisioned registry (used when `useProvisionedRegistry: true` in MCPServer spec) |
+| `PROVISIONED_REGISTRY_USERNAME` | (none) | Username for provisioned registry authentication |
+| `PROVISIONED_REGISTRY_PASSWORD` | (none) | Password for provisioned registry authentication |
+| `PROVISIONED_REGISTRY_SECRET_NAME` | `mcp-runtime-registry-creds` | Name of the Kubernetes secret for registry credentials |
+| `REQUEUE_DELAY_SECONDS` | `10` | Delay in seconds before requeueing when resources aren't ready |
 
 Examples:
 ```bash
@@ -144,14 +171,28 @@ MCP_SKOPEO_IMAGE=my-registry.local/skopeo:v1.14 mcp-runtime registry push myimag
 
 # Use pre-built operator image
 MCP_OPERATOR_IMAGE=ghcr.io/myorg/mcp-operator:v1.0 mcp-runtime setup
+
+# Configure external registry for CLI
+PROVISIONED_REGISTRY_URL=registry.example.com \
+PROVISIONED_REGISTRY_USERNAME=admin \
+PROVISIONED_REGISTRY_PASSWORD=secret \
+mcp-runtime registry provision --url registry.example.com
+
+# Configure operator to use external registry (set in operator deployment)
+# This allows MCPServer resources with useProvisionedRegistry: true to use the external registry
+kubectl set env deployment/mcp-runtime-operator-controller-manager \
+  -n mcp-runtime \
+  PROVISIONED_REGISTRY_URL=registry.example.com \
+  PROVISIONED_REGISTRY_USERNAME=admin \
+  PROVISIONED_REGISTRY_PASSWORD=secret
 ```
 
 
 ## Quick Start
 
 ```bash
 # 1. Clone and build
-git clone https://github.com/Agent-Hellboy/mcp-runtime.git
+git clone https://mcp-runtime.git
 cd mcp-runtime
 make install && make build-runtime
 
@@ -203,17 +244,6 @@ mcp-runtime cluster    # Cluster operations
 
 ## Development
 
-### Code Structure
-
-```
-├── cmd/                 # CLI and operator entry points
-├── internal/            # CLI and operator implementations
-├── api/                 # Kubernetes CRD definitions
-├── config/              # Kubernetes manifests
-├── examples/            # Working examples
-└── test/                # Tests
-```
-
 ### Building
 
 ```bash
@@ -286,9 +316,11 @@ The platform uses `mcp-runtime.org` as the default API group. If you want to use
 ## Troubleshooting
 
 ```bash
-# Check platform health
+# Check platform health 
 mcp-runtime status
 
+almost all subcommands has status 
+
 # View logs
 kubectl logs -n mcp-runtime deployment/mcp-runtime-operator-controller-manager
 kubectl logs -n registry deployment/registry

go.mod

@@ -1,6 +1,6 @@
 module mcp-runtime
 
-go 1.23.0
+go 1.24.11
 
 require (
 	github.com/go-logr/logr v1.2.4

hack/staticcheck.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+gopath="$(go env GOPATH)"
+bin="${gopath}/bin/staticcheck"
+
+if [[ ! -x "${bin}" ]]; then
+  echo "staticcheck not found at ${bin}. Install with:" >&2
+  echo "  GOTOOLCHAIN=go1.24.11 go install honnef.co/go/tools/cmd/staticcheck@latest" >&2
+  exit 1
+fi
+
+exec "${bin}" "$@"

internal/cli/build.go

@@ -20,6 +20,9 @@ import (
 	"gopkg.in/yaml.v3"
 )
 
+// yamlMarshal is a test seam for yaml.Marshal.
+var yamlMarshal = yaml.Marshal
+
 func newBuildImageCmd(logger *zap.Logger) *cobra.Command {
 	var dockerfile string
 	var metadataFile string
@@ -148,7 +151,7 @@ func updateMetadataImage(serverName, imageName, tag, metadataFile, metadataDir s
 	}
 
 	// Write back
-	data, err := yaml.Marshal(registry)
+	data, err := yamlMarshal(registry)
 	if err != nil {
 		return fmt.Errorf("failed to marshal metadata: %w", err)
 	}