464 add group creation command (#1105)

Author: amirejaz

cmd/thv/app/commands.go

@@ -52,6 +52,7 @@ func NewRootCmd(enableUpdates bool) *cobra.Command {
 	rootCmd.AddCommand(newSecretCommand())
 	rootCmd.AddCommand(inspectorCommand())
 	rootCmd.AddCommand(newMCPCommand())
+	//rootCmd.AddCommand(groupCmd) // TODO: add back in once we have a working group command, and update the docs
 
 	// Silence printing the usage on error
 	rootCmd.SilenceUsage = true

cmd/thv/app/group.go

@@ -0,0 +1,44 @@
+package app
+
+import (
+	"fmt"
+
+	"github.com/spf13/cobra"
+
+	"github.com/stacklok/toolhive/pkg/groups"
+)
+
+var groupCmd = &cobra.Command{
+	Use:   "group",
+	Short: "Manage logical groupings of MCP servers",
+	Long:  `The group command provides subcommands to manage logical groupings of MCP servers.`,
+}
+
+var groupCreateCmd = &cobra.Command{
+	Use:   "create [group-name]",
+	Short: "Create a new group of MCP servers",
+	Long:  `Create a new logical group of MCP servers. The group can be used to organize and manage multiple MCP servers together.`,
+	Args:  cobra.ExactArgs(1),
+	RunE:  groupCreateCmdFunc,
+}
+
+func groupCreateCmdFunc(cmd *cobra.Command, args []string) error {
+	groupName := args[0]
+	ctx := cmd.Context()
+
+	manager, err := groups.NewManager()
+	if err != nil {
+		return fmt.Errorf("failed to create group manager: %w", err)
+	}
+
+	if err := manager.Create(ctx, groupName); err != nil {
+		return err
+	}
+
+	fmt.Printf("Group '%s' created successfully.\n", groupName)
+	return nil
+}
+
+func init() {
+	groupCmd.AddCommand(groupCreateCmd)
+}

pkg/groups/group.go

@@ -0,0 +1,43 @@
+// Package groups provides functionality for managing logical groupings of MCP servers.
+// It includes types and interfaces for creating, retrieving, listing, and deleting groups.
+package groups
+
+import (
+	"context"
+	"encoding/json"
+	"os"
+)
+
+// Group represents a logical grouping of MCP servers.
+type Group struct {
+	Name string `json:"name"`
+}
+
+// WriteJSON serializes the Group to JSON and writes it to the provided writer
+func (g *Group) WriteJSON(w *os.File) error {
+	encoder := json.NewEncoder(w)
+	encoder.SetIndent("", "  ")
+	return encoder.Encode(g)
+}
+
+// Manager defines the interface for managing groups of MCP servers.
+// It provides methods for creating, retrieving, listing, and deleting groups.
+type Manager interface {
+	// Create creates a new group with the specified name.
+	// Returns an error if a group with the same name already exists.
+	Create(ctx context.Context, name string) error
+
+	// Get retrieves a group by name.
+	// Returns an error if the group does not exist.
+	Get(ctx context.Context, name string) (*Group, error)
+
+	// List returns all groups.
+	List(ctx context.Context) ([]*Group, error)
+
+	// Delete removes a group by name.
+	// Returns an error if the group does not exist.
+	Delete(ctx context.Context, name string) error
+
+	// Exists checks if a group with the specified name exists.
+	Exists(ctx context.Context, name string) (bool, error)
+}