feat: enhance thv mcp list to accept server names in addition to URLs

- Modified --server flag to accept both URLs and server names from running workloads
- Added resolveServerURL function to look up running servers by name
- Uses efficient GetWorkload method instead of listing all workloads
- Improved error messages for better user experience
- Removed unnecessary logger calls that could corrupt JSON output

This allows users to conveniently reference MCP servers by their friendly names
(e.g., 'thv mcp list --server fetch') instead of having to remember or look up
their URLs, while maintaining backward compatibility with direct URL usage.

Signed-off-by: Juan Antonio Osorio <[email protected]>

Author: JAORMX

cmd/thv/app/mcp.go

@@ -19,6 +19,7 @@ import (
 	"github.com/stacklok/toolhive/pkg/transport/streamable"
 	"github.com/stacklok/toolhive/pkg/transport/types"
 	"github.com/stacklok/toolhive/pkg/versions"
+	"github.com/stacklok/toolhive/pkg/workloads"
 )
 
 var (
@@ -86,7 +87,7 @@ func newMCPCommand() *cobra.Command {
 }
 
 func addMCPFlags(cmd *cobra.Command) {
-	cmd.Flags().StringVar(&mcpServerURL, "server", "", "MCP server URL (required)")
+	cmd.Flags().StringVar(&mcpServerURL, "server", "", "MCP server URL or name from ToolHive registry (required)")
 	cmd.Flags().StringVar(&mcpFormat, "format", FormatText, "Output format (json or text)")
 	cmd.Flags().DurationVar(&mcpTimeout, "timeout", 30*time.Second, "Connection timeout")
 	cmd.Flags().StringVar(&mcpTransport, "transport", "auto", "Transport type (auto, sse, streamable-http)")
@@ -98,7 +99,13 @@ func mcpListCmdFunc(cmd *cobra.Command, _ []string) error {
 	ctx, cancel := context.WithTimeout(cmd.Context(), mcpTimeout)
 	defer cancel()
 
-	mcpClient, err := createMCPClient()
+	// Resolve server URL if it's a name
+	serverURL, err := resolveServerURL(ctx, mcpServerURL)
+	if err != nil {
+		return err
+	}
+
+	mcpClient, err := createMCPClient(serverURL)
 	if err != nil {
 		return err
 	}
@@ -143,7 +150,13 @@ func mcpListToolsCmdFunc(cmd *cobra.Command, _ []string) error {
 	ctx, cancel := context.WithTimeout(cmd.Context(), mcpTimeout)
 	defer cancel()
 
-	mcpClient, err := createMCPClient()
+	// Resolve server URL if it's a name
+	serverURL, err := resolveServerURL(ctx, mcpServerURL)
+	if err != nil {
+		return err
+	}
+
+	mcpClient, err := createMCPClient(serverURL)
 	if err != nil {
 		return err
 	}
@@ -166,7 +179,13 @@ func mcpListResourcesCmdFunc(cmd *cobra.Command, _ []string) error {
 	ctx, cancel := context.WithTimeout(cmd.Context(), mcpTimeout)
 	defer cancel()
 
-	mcpClient, err := createMCPClient()
+	// Resolve server URL if it's a name
+	serverURL, err := resolveServerURL(ctx, mcpServerURL)
+	if err != nil {
+		return err
+	}
+
+	mcpClient, err := createMCPClient(serverURL)
 	if err != nil {
 		return err
 	}
@@ -189,7 +208,13 @@ func mcpListPromptsCmdFunc(cmd *cobra.Command, _ []string) error {
 	ctx, cancel := context.WithTimeout(cmd.Context(), mcpTimeout)
 	defer cancel()
 
-	mcpClient, err := createMCPClient()
+	// Resolve server URL if it's a name
+	serverURL, err := resolveServerURL(ctx, mcpServerURL)
+	if err != nil {
+		return err
+	}
+
+	mcpClient, err := createMCPClient(serverURL)
 	if err != nil {
 		return err
 	}
@@ -207,19 +232,45 @@ func mcpListPromptsCmdFunc(cmd *cobra.Command, _ []string) error {
 	return outputMCPData(map[string]interface{}{"prompts": result.Prompts}, mcpFormat)
 }
 
+// resolveServerURL resolves a server name to a URL or returns the URL if it's already a URL
+func resolveServerURL(ctx context.Context, serverInput string) (string, error) {
+	// Check if it's already a URL
+	if strings.HasPrefix(serverInput, "http://") || strings.HasPrefix(serverInput, "https://") {
+		return serverInput, nil
+	}
+
+	// Try to get the workload by name
+	manager, err := workloads.NewManager(ctx)
+	if err != nil {
+		return "", fmt.Errorf("failed to create workload manager: %w", err)
+	}
+
+	workload, err := manager.GetWorkload(ctx, serverInput)
+	if err != nil {
+		return "", fmt.Errorf("server '%s' not found in running workloads. Please ensure the server is running or provide a valid URL", serverInput)
+	}
+
+	// Check if the workload is running
+	if workload.Status != "running" {
+		return "", fmt.Errorf("server '%s' is not running (status: %s). Please start it first using 'thv run %s'", serverInput, workload.Status, serverInput)
+	}
+
+	return workload.URL, nil
+}
+
 // createMCPClient creates an MCP client based on the server URL and transport type
-func createMCPClient() (*client.Client, error) {
-	transportType := determineTransportType(mcpServerURL, mcpTransport)
+func createMCPClient(serverURL string) (*client.Client, error) {
+	transportType := determineTransportType(serverURL, mcpTransport)
 
 	switch transportType {
 	case types.TransportTypeSSE:
-		mcpClient, err := client.NewSSEMCPClient(mcpServerURL)
+		mcpClient, err := client.NewSSEMCPClient(serverURL)
 		if err != nil {
 			return nil, fmt.Errorf("failed to create SSE MCP client: %w", err)
 		}
 		return mcpClient, nil
 	case types.TransportTypeStreamableHTTP:
-		mcpClient, err := client.NewStreamableHttpClient(mcpServerURL)
+		mcpClient, err := client.NewStreamableHttpClient(serverURL)
 		if err != nil {
 			return nil, fmt.Errorf("failed to create Streamable HTTP MCP client: %w", err)
 		}