Add Kubernetes export format to thv export command

Add support for exporting MCP server configurations as Kubernetes
MCPServer resources with the --format flag. Users can now export
their running servers to K8s manifests for deployment in Kubernetes.

Changes:
- Add pkg/export package with k8s.go for converting RunConfig to MCPServer CRD
- Enhance thv export command with --format flag (json/k8s)
- Convert all RunConfig fields to appropriate MCPServer spec fields
- Handle environment variables, volumes, OIDC, authz, audit, telemetry
- Sanitize names to comply with Kubernetes naming requirements
- Add comprehensive unit tests for all export functionality
- Add e2e tests for export command with both formats

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: JAORMX

cmd/thv/app/export.go

@@ -7,35 +7,54 @@ import (
 
 	"github.com/spf13/cobra"
 
+	"github.com/stacklok/toolhive/pkg/export"
 	"github.com/stacklok/toolhive/pkg/runner"
 )
 
+var exportFormat string
+
 func newExportCmd() *cobra.Command {
-	return &cobra.Command{
+	cmd := &cobra.Command{
 		Use:   "export <workload name> <path>",
 		Short: "Export a workload's run configuration to a file",
 		Long: `Export a workload's run configuration to a file for sharing or backup.
 
 The exported configuration can be used with 'thv run --from-config <path>' to recreate
 the same workload with identical settings.
 
+You can export in different formats:
+- json: Export as RunConfig JSON (default, can be used with 'thv run --from-config')
+- k8s: Export as Kubernetes MCPServer resource YAML
+
 Examples:
 
-	# Export a workload configuration to a file
+	# Export a workload configuration to a JSON file
 	thv export my-server ./my-server-config.json
 
+	# Export as Kubernetes MCPServer resource
+	thv export my-server ./my-server.yaml --format k8s
+
 	# Export to a specific directory
 	thv export github-mcp /tmp/configs/github-config.json`,
 		Args: cobra.ExactArgs(2),
 		RunE: exportCmdFunc,
 	}
+
+	cmd.Flags().StringVar(&exportFormat, "format", "json", "Export format: json or k8s")
+
+	return cmd
 }
 
 func exportCmdFunc(cmd *cobra.Command, args []string) error {
 	ctx := cmd.Context()
 	workloadName := args[0]
 	outputPath := args[1]
 
+	// Validate format
+	if exportFormat != "json" && exportFormat != "k8s" {
+		return fmt.Errorf("invalid format '%s': must be 'json' or 'k8s'", exportFormat)
+	}
+
 	// Load the saved run configuration
 	runConfig, err := runner.LoadState(ctx, workloadName)
 	if err != nil {
@@ -56,11 +75,19 @@ func exportCmdFunc(cmd *cobra.Command, args []string) error {
 	}
 	defer outputFile.Close()
 
-	// Write the configuration to the file
-	if err := runConfig.WriteJSON(outputFile); err != nil {
-		return fmt.Errorf("failed to write configuration to file: %w", err)
+	// Write the configuration based on format
+	switch exportFormat {
+	case "json":
+		if err := runConfig.WriteJSON(outputFile); err != nil {
+			return fmt.Errorf("failed to write configuration to file: %w", err)
+		}
+		fmt.Printf("Successfully exported run configuration for '%s' to '%s'\n", workloadName, outputPath)
+	case "k8s":
+		if err := export.WriteK8sManifest(runConfig, outputFile); err != nil {
+			return fmt.Errorf("failed to write Kubernetes manifest: %w", err)
+		}
+		fmt.Printf("Successfully exported Kubernetes MCPServer resource for '%s' to '%s'\n", workloadName, outputPath)
 	}
 
-	fmt.Printf("Successfully exported run configuration for '%s' to '%s'\n", workloadName, outputPath)
 	return nil
 }

cmd/thv/app/version.go

@@ -38,7 +38,7 @@ func newVersionCmd() *cobra.Command {
 	// If --json is set, override the format
 	cmd.PreRun = func(_ *cobra.Command, _ []string) {
 		if jsonOutput {
-			outputFormat = "json"
+			outputFormat = FormatJSON
 		}
 	}