MCP: port "install" command from aitools (#3962)

## Changes
Introduces `databricks experimental apps-mcp install` command to
simplify installing the MCP into Coding agents. This is basically copied
over from @lennartkats-db's `aitools` command.

<img width="962" height="749" alt="Screenshot 2025-11-20 at 10 35 10"
src="https://github.com/user-attachments/assets/955a330a-752d-499f-af37-76ad12b0962d"
/>

## Why

Make onboarding easier.

## Tests
Manually ran the `install` command and validated that it works with
Cursor and Claude Code.

<!-- If your PR needs to be included in the release notes for next
release,
add a separate entry in NEXT_CHANGELOG.md as part of your PR. -->

Author: fjakobs

experimental/apps-mcp/cmd/apps_mcp.go

@@ -82,5 +82,7 @@ The server communicates via stdio using the Model Context Protocol.`,
 	cmd.Flags().BoolVar(&allowDeployment, "allow-deployment", false, "Enable deployment tools")
 	cmd.Flags().BoolVar(&withWorkspaceTools, "with-workspace-tools", false, "Enable workspace tools (file operations, bash, grep, glob)")
 
+	cmd.AddCommand(newInstallCmd())
+
 	return cmd
 }

experimental/apps-mcp/cmd/install.go

@@ -0,0 +1,97 @@
+package mcp
+
+import (
+	"context"
+	"fmt"
+	"os"
+	"time"
+
+	"github.com/databricks/cli/experimental/apps-mcp/lib/agents"
+	"github.com/databricks/cli/libs/cmdio"
+	"github.com/fatih/color"
+	"github.com/spf13/cobra"
+)
+
+func newInstallCmd() *cobra.Command {
+	cmd := &cobra.Command{
+		Use:   "install",
+		Short: "Install the Apps MCP server in coding agents",
+		Long:  `Install the Databricks Apps MCP server in coding agents like Claude Code and Cursor.`,
+		RunE: func(cmd *cobra.Command, args []string) error {
+			return runInstall(cmd.Context())
+		},
+	}
+
+	return cmd
+}
+
+func runInstall(ctx context.Context) error {
+	cmdio.LogString(ctx, "")
+	green := color.New(color.FgGreen).SprintFunc()
+	cmdio.LogString(ctx, " "+green("[")+"████████"+green("]")+"  Databricks Experimental Apps MCP")
+	cmdio.LogString(ctx, " "+green("[")+"██▌  ▐██"+green("]"))
+	cmdio.LogString(ctx, " "+green("[")+"████████"+green("]")+"  AI-powered Databricks Apps development and exploration")
+	cmdio.LogString(ctx, "")
+
+	yellow := color.New(color.FgYellow).SprintFunc()
+	cmdio.LogString(ctx, yellow("╔════════════════════════════════════════════════════════════════╗"))
+	cmdio.LogString(ctx, yellow("║  ⚠️  EXPERIMENTAL: This command may change in future versions   ║"))
+	cmdio.LogString(ctx, yellow("╚════════════════════════════════════════════════════════════════╝"))
+	cmdio.LogString(ctx, "")
+
+	cmdio.LogString(ctx, "Which coding agents would you like to install the MCP server for?")
+	cmdio.LogString(ctx, "")
+
+	anySuccess := false
+
+	ans, err := cmdio.AskSelect(ctx, "Install for Claude Code?", []string{"yes", "no"})
+	if err != nil {
+		return err
+	}
+	if ans == "yes" {
+		fmt.Fprint(os.Stderr, "Installing MCP server for Claude Code...")
+		if err := agents.InstallClaude(); err != nil {
+			fmt.Fprint(os.Stderr, "\r"+color.YellowString("⊘ Skipped Claude Code: "+err.Error())+"\n")
+		} else {
+			fmt.Fprint(os.Stderr, "\r"+color.GreenString("✓ Installed for Claude Code")+"                 \n")
+			anySuccess = true
+		}
+		cmdio.LogString(ctx, "")
+	}
+
+	ans, err = cmdio.AskSelect(ctx, "Install for Cursor?", []string{"yes", "no"})
+	if err != nil {
+		return err
+	}
+	if ans == "yes" {
+		fmt.Fprint(os.Stderr, "Installing MCP server for Cursor...")
+		if err := agents.InstallCursor(); err != nil {
+			fmt.Fprint(os.Stderr, "\r"+color.YellowString("⊘ Skipped Cursor: "+err.Error())+"\n")
+		} else {
+			// Brief delay so users see the "Installing..." message before it's replaced
+			time.Sleep(1 * time.Second)
+			fmt.Fprint(os.Stderr, "\r"+color.GreenString("✓ Installed for Cursor")+"                 \n")
+			anySuccess = true
+		}
+		cmdio.LogString(ctx, "")
+	}
+
+	ans, err = cmdio.AskSelect(ctx, "Show manual installation instructions for other agents?", []string{"yes", "no"})
+	if err != nil {
+		return err
+	}
+	if ans == "yes" {
+		if err := agents.ShowCustomInstructions(ctx); err != nil {
+			return err
+		}
+	}
+
+	if anySuccess {
+		cmdio.LogString(ctx, "")
+		cmdio.LogString(ctx, "You can now use your coding agent to interact with Databricks.")
+		cmdio.LogString(ctx, "")
+		cmdio.LogString(ctx, "Try asking: "+color.YellowString("Create an app that calculates taxi trip metrics: average fare by distance bracket and time of day."))
+	}
+
+	return nil
+}

experimental/apps-mcp/lib/agents/claude.go

@@ -0,0 +1,43 @@
+package agents
+
+import (
+	"errors"
+	"fmt"
+	"os"
+	"os/exec"
+)
+
+// DetectClaude checks if Claude Code CLI is installed and available on PATH.
+func DetectClaude() bool {
+	_, err := exec.LookPath("claude")
+	return err == nil
+}
+
+// InstallClaude installs the Databricks MCP server in Claude Code.
+func InstallClaude() error {
+	if !DetectClaude() {
+		return errors.New("claude Code CLI is not installed or not on PATH\n\nPlease install Claude Code and ensure 'claude' is available on your system PATH.\nFor installation instructions, visit: https://docs.anthropic.com/en/docs/claude-code")
+	}
+
+	databricksPath, err := os.Executable()
+	if err != nil {
+		return err
+	}
+
+	removeCmd := exec.Command("claude", "mcp", "remove", "--scope", "user", "databricks-mcp")
+	_ = removeCmd.Run()
+
+	cmd := exec.Command("claude", "mcp", "add",
+		"--scope", "user",
+		"--transport", "stdio",
+		"databricks-mcp",
+		"--",
+		databricksPath, "experimental", "apps-mcp")
+
+	output, err := cmd.CombinedOutput()
+	if err != nil {
+		return fmt.Errorf("failed to install MCP server in Claude Code: %w\nOutput: %s", err, string(output))
+	}
+
+	return nil
+}

experimental/apps-mcp/lib/agents/cursor.go

@@ -0,0 +1,101 @@
+package agents
+
+import (
+	"encoding/json"
+	"fmt"
+	"os"
+	"path/filepath"
+	"runtime"
+)
+
+type cursorConfig struct {
+	McpServers map[string]mcpServer `json:"mcpServers"`
+}
+
+type mcpServer struct {
+	Command string            `json:"command"`
+	Args    []string          `json:"args,omitempty"`
+	Env     map[string]string `json:"env,omitempty"`
+}
+
+func getCursorConfigPath() (string, error) {
+	if runtime.GOOS == "windows" {
+		userProfile := os.Getenv("USERPROFILE")
+		if userProfile == "" {
+			return "", os.ErrNotExist
+		}
+		return filepath.Join(userProfile, ".cursor", "mcp.json"), nil
+	}
+
+	home, err := os.UserHomeDir()
+	if err != nil {
+		return "", err
+	}
+	return filepath.Join(home, ".cursor", "mcp.json"), nil
+}
+
+// DetectCursor checks if Cursor is installed by looking for its config directory.
+func DetectCursor() bool {
+	configPath, err := getCursorConfigPath()
+	if err != nil {
+		return false
+	}
+	// Check if the .cursor directory exists (not just the mcp.json file)
+	cursorDir := filepath.Dir(configPath)
+	_, err = os.Stat(cursorDir)
+	return err == nil
+}
+
+// InstallCursor installs the Databricks MCP server in Cursor.
+func InstallCursor() error {
+	configPath, err := getCursorConfigPath()
+	if err != nil {
+		return fmt.Errorf("failed to determine Cursor config path: %w", err)
+	}
+
+	// Check if .cursor directory exists (not the file, we'll create that if needed)
+	cursorDir := filepath.Dir(configPath)
+	if _, err := os.Stat(cursorDir); err != nil {
+		return fmt.Errorf("cursor directory not found at: %s\n\nPlease install Cursor from: https://cursor.sh", cursorDir)
+	}
+
+	// Read existing config
+	var config cursorConfig
+	data, err := os.ReadFile(configPath)
+	if err != nil {
+		// If file doesn't exist or can't be read, start with empty config
+		config = cursorConfig{
+			McpServers: make(map[string]mcpServer),
+		}
+	} else {
+		if err := json.Unmarshal(data, &config); err != nil {
+			return fmt.Errorf("failed to parse Cursor config: %w", err)
+		}
+		if config.McpServers == nil {
+			config.McpServers = make(map[string]mcpServer)
+		}
+	}
+
+	databricksPath, err := os.Executable()
+	if err != nil {
+		return fmt.Errorf("failed to determine Databricks path: %w", err)
+	}
+
+	// Add or update the Databricks MCP server entry
+	config.McpServers["databricks-mcp"] = mcpServer{
+		Command: databricksPath,
+		Args:    []string{"experimental", "apps-mcp"},
+	}
+
+	// Write back to file with pretty printing
+	updatedData, err := json.MarshalIndent(config, "", "  ")
+	if err != nil {
+		return fmt.Errorf("failed to marshal Cursor config: %w", err)
+	}
+
+	if err := os.WriteFile(configPath, updatedData, 0o644); err != nil {
+		return fmt.Errorf("failed to write Cursor config: %w", err)
+	}
+
+	return nil
+}

experimental/apps-mcp/lib/agents/custom.go

@@ -0,0 +1,36 @@
+package agents
+
+import (
+	"context"
+
+	"github.com/databricks/cli/libs/cmdio"
+)
+
+// ShowCustomInstructions displays instructions for manually installing the MCP server.
+func ShowCustomInstructions(ctx context.Context) error {
+	instructions := `
+To install the Databricks CLI MCP server in your coding agent:
+
+1. Add a new MCP server to your coding agent's configuration
+2. Set the command to: "databricks experimental apps-mcp"
+3. No environment variables or additional configuration needed
+
+Example MCP server configuration:
+{
+  "mcpServers": {
+    "databricks": {
+      "command": "databricks",
+      "args": ["experimental", "apps-mcp"]
+    }
+  }
+}
+`
+	cmdio.LogString(ctx, instructions)
+
+	_, err := cmdio.Ask(ctx, "Press Enter to continue", "")
+	if err != nil {
+		return err
+	}
+	cmdio.LogString(ctx, "")
+	return nil
+}