feat(tray): add "Install server…" menu entry deep-linking to marketplace

Add an "Install server…" item to the Go systray, placed just after
"Open Web Control Panel". Clicking it deep-links to the Web UI
marketplace (/repositories, Repositories.vue) in the default browser.

- client.go: extract OpenWebUIPath(path) from OpenWebUI; new pure
  appendWebUIPath helper joins a relative path onto the resolved
  web_ui_url while preserving any existing query string (apikey).
- tray.go: new menu item + click handler + handleInstallServer.
- tray_stub.go: widen apiClient interface to match.
- docs: list the new tray entry in quick-start.

Related #MCP-3246

Author: Dumbris

cmd/mcpproxy-tray/internal/api/client.go

@@ -819,8 +819,15 @@ func (c *Client) SearchTools(query string, limit int) ([]SearchResult, error) {
 	return searchResults, nil
 }
 
-// OpenWebUI opens the web control panel in the default browser
+// OpenWebUI opens the web control panel in the default browser.
 func (c *Client) OpenWebUI() error {
+	return c.OpenWebUIPath("")
+}
+
+// OpenWebUIPath opens the web control panel in the default browser at the given
+// path under the resolved web UI base (e.g. "repositories" for the marketplace
+// deep-link). An empty path opens the base control panel, matching OpenWebUI.
+func (c *Client) OpenWebUIPath(path string) error {
 	// Get the actual web UI URL from the /api/v1/info endpoint
 	// This ensures we use the correct HTTP URL even when connected via socket
 	resp, err := c.makeRequest("GET", "/api/v1/info", nil)
@@ -841,6 +848,13 @@ func (c *Client) OpenWebUI() error {
 		return fmt.Errorf("web_ui_url not found in server info")
 	}
 
+	// Append the requested deep-link path (preserving any query string such as
+	// the apikey the core may already include in web_ui_url).
+	webUIURL, err = appendWebUIPath(webUIURL, path)
+	if err != nil {
+		return fmt.Errorf("failed to build web UI URL: %w", err)
+	}
+
 	// Add API key if not using socket communication
 	url := webUIURL
 	if c.apiKey != "" && !strings.HasPrefix(c.baseURL, "unix://") && !strings.HasPrefix(c.baseURL, "npipe://") {
@@ -887,6 +901,27 @@ func (c *Client) OpenWebUI() error {
 	}
 }
 
+// appendWebUIPath joins a relative path onto a resolved web UI base URL,
+// preserving any existing query string (e.g. an apikey already embedded by the
+// core). An empty path returns the base URL unchanged.
+func appendWebUIPath(webUIURL, path string) (string, error) {
+	if path == "" {
+		return webUIURL, nil
+	}
+
+	u, err := url.Parse(webUIURL)
+	if err != nil {
+		return "", fmt.Errorf("invalid web UI URL %q: %w", webUIURL, err)
+	}
+
+	if !strings.HasSuffix(u.Path, "/") {
+		u.Path += "/"
+	}
+	u.Path += strings.TrimPrefix(path, "/")
+
+	return u.String(), nil
+}
+
 // makeRequest makes an HTTP request to the API with enhanced error handling and retry logic
 func (c *Client) makeRequest(method, path string, _ interface{}) (*Response, error) {
 	url, err := c.buildURL(path)

cmd/mcpproxy-tray/internal/api/client_test.go

@@ -64,3 +64,66 @@ func TestClientGetServers_LogsZeroServersOnlyOnStateChange(t *testing.T) {
 	assert.Equal(t, 2, recorded.FilterMessage("API returned zero upstream servers").Len())
 	assert.Equal(t, 1, recorded.FilterMessage("Server state changed").Len())
 }
+
+func TestAppendWebUIPath(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name      string
+		webUIURL  string
+		path      string
+		want      string
+		expectErr bool
+	}{
+		{
+			name:     "empty path returns base unchanged",
+			webUIURL: "http://127.0.0.1:8080/ui/",
+			path:     "",
+			want:     "http://127.0.0.1:8080/ui/",
+		},
+		{
+			name:     "appends path to trailing-slash base",
+			webUIURL: "http://127.0.0.1:8080/ui/",
+			path:     "repositories",
+			want:     "http://127.0.0.1:8080/ui/repositories",
+		},
+		{
+			name:     "appends path when base lacks trailing slash",
+			webUIURL: "http://127.0.0.1:8080/ui",
+			path:     "repositories",
+			want:     "http://127.0.0.1:8080/ui/repositories",
+		},
+		{
+			name:     "leading slash on path is normalized",
+			webUIURL: "http://127.0.0.1:8080/ui/",
+			path:     "/repositories",
+			want:     "http://127.0.0.1:8080/ui/repositories",
+		},
+		{
+			name:     "preserves existing query string (apikey)",
+			webUIURL: "http://127.0.0.1:8080/ui/?apikey=secret",
+			path:     "repositories",
+			want:     "http://127.0.0.1:8080/ui/repositories?apikey=secret",
+		},
+		{
+			name:      "invalid URL returns error",
+			webUIURL:  "ht tp://bad url",
+			path:      "repositories",
+			expectErr: true,
+		},
+	}
+
+	for _, tt := range tests {
+		tt := tt
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+			got, err := appendWebUIPath(tt.webUIURL, tt.path)
+			if tt.expectErr {
+				require.Error(t, err)
+				return
+			}
+			require.NoError(t, err)
+			assert.Equal(t, tt.want, got)
+		})
+	}
+}

docs/getting-started/quick-start.md

@@ -55,6 +55,7 @@ If you installed MCPProxy using the **DMG installer** (macOS) or **Windows insta
 :::tip Tray Menu Options
 Right-click (or click on macOS) the tray icon to access:
 - **Open Web UI** - Launch the management dashboard
+- **Install server…** - Open the Web UI marketplace to browse and install MCP servers
 - **View Logs** - See server activity
 - **Upstream Servers** - View status of all MCP servers, enable/disable individual servers
 - **Quit** - Stop MCPProxy completely

internal/tray/tray.go

@@ -93,10 +93,13 @@ type ServerInterface interface {
 // App represents the system tray application
 type App struct {
 	server    ServerInterface
-	apiClient interface{ OpenWebUI() error } // API client for web UI access (optional)
-	logger    *zap.SugaredLogger
-	version   string
-	shutdown  func()
+	apiClient interface {
+		OpenWebUI() error
+		OpenWebUIPath(path string) error
+	} // API client for web UI access (optional)
+	logger   *zap.SugaredLogger
+	version  string
+	shutdown func()
 
 	connectionState   ConnectionState
 	connectionStateMu sync.RWMutex
@@ -128,11 +131,11 @@ type App struct {
 	autostartItem    *systray.MenuItem
 
 	// Update notification menu item (hidden until update is available)
-	updateMenuItem     *systray.MenuItem
-	updateAvailable    bool
-	latestVersion      string
-	latestReleaseURL   string
-	updateCheckMu      sync.RWMutex
+	updateMenuItem   *systray.MenuItem
+	updateAvailable  bool
+	latestVersion    string
+	latestReleaseURL string
+	updateCheckMu    sync.RWMutex
 
 	// Config path for opening from menu
 	configPath string
@@ -161,7 +164,10 @@ func New(server ServerInterface, logger *zap.SugaredLogger, version string, shut
 }
 
 // NewWithAPIClient creates a new tray application with an API client for web UI access
-func NewWithAPIClient(server ServerInterface, apiClient interface{ OpenWebUI() error }, logger *zap.SugaredLogger, version string, shutdown func()) *App {
+func NewWithAPIClient(server ServerInterface, apiClient interface {
+	OpenWebUI() error
+	OpenWebUIPath(path string) error
+}, logger *zap.SugaredLogger, version string, shutdown func()) *App {
 	app := &App{
 		server:          server,
 		apiClient:       apiClient,
@@ -574,8 +580,12 @@ func (a *App) onReady() {
 
 	// Add Web Control Panel menu item if API client is available
 	var openWebUIItem *systray.MenuItem
+	var installServerItem *systray.MenuItem
 	if a.apiClient != nil {
 		openWebUIItem = systray.AddMenuItem("Open Web Control Panel", "Open the web control panel in your browser")
+		// Deep-link into the Web UI marketplace (Repositories.vue) to browse
+		// and install MCP servers (MCP-37a).
+		installServerItem = systray.AddMenuItem("Install server…", "Browse and install MCP servers in the web UI marketplace")
 	}
 	systray.AddSeparator()
 
@@ -744,6 +754,20 @@ func (a *App) onReady() {
 		}()
 	}
 
+	// --- Install Server Click Handler (deep-link to the marketplace) ---
+	if installServerItem != nil {
+		go func() {
+			for {
+				select {
+				case <-installServerItem.ClickedCh:
+					a.handleInstallServer()
+				case <-a.ctx.Done():
+					return
+				}
+			}
+		}()
+	}
+
 	// --- Autostart Click Handler (separate goroutine for macOS) ---
 	if runtime.GOOS == osDarwin && a.autostartItem != nil {
 		go func() {
@@ -1768,6 +1792,23 @@ func (a *App) handleOpenWebUI() {
 	}
 }
 
+// handleInstallServer deep-links to the Web UI marketplace (Repositories.vue)
+// so users can browse and install MCP servers (MCP-37a).
+func (a *App) handleInstallServer() {
+	if a.apiClient == nil {
+		a.logger.Warn("API client not available, cannot open marketplace")
+		return
+	}
+
+	a.logger.Info("Opening server marketplace from tray menu")
+
+	if err := a.apiClient.OpenWebUIPath("repositories"); err != nil {
+		a.logger.Error("Failed to open server marketplace", zap.Error(err))
+	} else {
+		a.logger.Info("Successfully opened server marketplace")
+	}
+}
+
 // startUpdateChecker starts a background goroutine that periodically checks for updates
 // by querying the core's /api/v1/info endpoint
 func (a *App) startUpdateChecker() {

internal/tray/tray_stub.go

@@ -51,7 +51,10 @@ func New(_ ServerInterface, logger *zap.SugaredLogger, _ string, _ func()) *App
 }
 
 // NewWithAPIClient creates a new tray application with an API client (stub version)
-func NewWithAPIClient(_ ServerInterface, _ interface{ OpenWebUI() error }, logger *zap.SugaredLogger, _ string, _ func()) *App {
+func NewWithAPIClient(_ ServerInterface, _ interface {
+	OpenWebUI() error
+	OpenWebUIPath(path string) error
+}, logger *zap.SugaredLogger, _ string, _ func()) *App {
 	return &App{
 		logger: logger,
 	}