Added the ability to test crd equivalence call from the CLI. (#6810)

### BRIEF Change description

Added the ability to test crd equivalence call from the CLI.

Fixes #

#### WHY do we need this change?

#### Special notes for your reviewer:

#### Does this PR add something which needs to be 'release noted'?
```release-note
NONE
```

- [ ] Reviewer reviewed release note.

#### Additional documentation e.g., references, usage docs, etc.:

```docs
NONE
```

#### Intended Milestone

Please indicate the intended milestone.
- [ ] Reviewer tagged PR with the actual milestone.

### Tests you have done

- [ ] Run `make ready-pr` to ensure this PR is ready for review.
- [ ] Perform necessary E2E testing for changed resources.

Author: maqiuyujoyce

.gemini/settings.json

@@ -10,6 +10,7 @@
         "crd": {
             "command": "dev/mcp/crd-mcp-server",
             "args": [
+                "stdio"
             ]
         }
     }

dev/tools/crd-mcp-server/go.mod

@@ -31,6 +31,7 @@ require (
 	github.com/go-logr/logr v1.4.2 // indirect
 	github.com/gogo/protobuf v1.3.2 // indirect
 	github.com/google/uuid v1.6.0 // indirect
+	github.com/inconshreveable/mousetrap v1.1.0 // indirect
 	github.com/invopop/jsonschema v0.13.0 // indirect
 	github.com/json-iterator/go v1.1.12 // indirect
 	github.com/mailru/easyjson v0.7.7 // indirect
@@ -39,6 +40,8 @@ require (
 	github.com/modern-go/reflect2 v1.0.2 // indirect
 	github.com/pkg/errors v0.9.1 // indirect
 	github.com/spf13/cast v1.7.1 // indirect
+	github.com/spf13/cobra v1.10.2 // indirect
+	github.com/spf13/pflag v1.0.9 // indirect
 	github.com/tidwall/gjson v1.18.0 // indirect
 	github.com/tidwall/match v1.1.1 // indirect
 	github.com/tidwall/pretty v1.2.1 // indirect

dev/tools/crd-mcp-server/go.sum

@@ -16,12 +16,14 @@
 package main
 
 import (
+	"context"
 	"fmt"
 	"os"
 	"strings"
 
 	"github.com/metoro-io/mcp-golang"
 	"github.com/metoro-io/mcp-golang/transport/stdio"
+	"github.com/spf13/cobra"
 )
 
 const (
@@ -55,7 +57,88 @@ type BackwardCompatArguments struct {
 	Ref  string `json:"ref" jsonschema:"description=Git ref for the old version (default: HEAD)."`
 }
 
+type StdioOptions struct {
+}
+
+type EquivalentOptions struct {
+	File string
+	Ref  string
+}
+
+type CompatibleOptions struct {
+	File string
+	Ref  string
+}
+
+
 func main() {
+	rootCmd := &cobra.Command{
+		Use:   "crd-mcp-server subcommand",
+		Short: "crd-mcp-server is a MCP server for KCC handling of CRDs.",
+	}
+
+	rootCmd.AddCommand(BuildStdioCmd())
+	rootCmd.AddCommand(BuildEquivalentCmd())
+	rootCmd.AddCommand(BuildCompatibleCmd())
+
+	if err := rootCmd.Execute(); err != nil {
+		fmt.Fprintf(os.Stderr, "%v\n", err)
+		os.Exit(1)
+	}
+}
+
+func BuildStdioCmd() *cobra.Command {
+	var opts StdioOptions
+	cmd := &cobra.Command{
+		Use:     "stdio",
+		Short:   "stdio",
+		Example: `crd-mcp-server stdio`,
+		RunE: func(cmd *cobra.Command, args []string) error {
+			return RunStdio(cmd.Context(), &opts)
+		},
+		Args: cobra.ExactArgs(0),
+	}
+
+	return cmd
+}
+
+func BuildEquivalentCmd() *cobra.Command {
+	var opts EquivalentOptions
+	cmd := &cobra.Command{
+		Use:     "equivalent",
+		Short:   "CLI version of the equivalent MCP. Is the CRD equivalent to the older form?",
+		Example: `crd-mcp-server equivalent`,
+		RunE: func(cmd *cobra.Command, args []string) error {
+			return RunEquivalent(cmd.Context(), &opts)
+		},
+		Args: cobra.ExactArgs(0),
+	}
+	cmd.Flags().StringVarP(&opts.File, "file", "", opts.File, "Path to the CRD YAML file to check.")
+	cmd.MarkFlagRequired("file") 
+	cmd.Flags().StringVarP(&opts.Ref, "ref", "", "HEAD", "Git ref for the old version (default: HEAD).")
+
+	return cmd
+}
+
+func BuildCompatibleCmd() *cobra.Command {
+	var opts CompatibleOptions
+	cmd := &cobra.Command{
+		Use:     "compatible",
+		Short:   "CLI version of the compatible MCP. Is the CRD backward compatible with the older form?",
+		Example: `crd-mcp-server compatible`,
+		RunE: func(cmd *cobra.Command, args []string) error {
+			return RunCompatible(cmd.Context(), &opts)
+		},
+		Args: cobra.ExactArgs(0),
+	}
+	cmd.Flags().StringVarP(&opts.File, "file", "", opts.File, "Path to the CRD YAML file to check.")
+	cmd.MarkFlagRequired("file") 
+	cmd.Flags().StringVarP(&opts.Ref, "ref", "", "HEAD", "Git ref for the old version (default: HEAD).")
+
+	return cmd
+}
+
+func RunStdio(ctx context.Context, opts *StdioOptions) error {
 	done := make(chan struct{})
 	server := mcp_golang.NewServer(stdio.NewStdioServerTransport())
 
@@ -71,6 +154,28 @@ func main() {
 	}
 
 	<-done
+
+	return nil
+}
+
+func RunEquivalent(ctx context.Context, opts *EquivalentOptions) error {
+	result, err := runEquivalenceCheck(opts.File, opts.Ref)
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Error: %v", err)
+		return err
+	}
+	fmt.Fprint(os.Stdout, result)
+	return nil
+}
+
+func RunCompatible(ctx context.Context, opts *CompatibleOptions) error {
+	result, err := runBackwardCompatCheck(opts.File, opts.Ref)
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "Error: %v", err)
+		return err
+	}
+	fmt.Fprint(os.Stdout, result)
+	return nil
 }
 
 func handleCheckEquivalence(arguments EquivalenceArguments) (*mcp_golang.ToolResponse, error) {