Claude Desktop Commander MCP

#!/bin/bash # Desktop Commander Docker Installation Script set -e # Colors for output RED='\033[0;31m' GREEN='\033[0;32m' YELLOW='\033[1;33m' BLUE='\033[0;34m' NC='\033[0m' # No Color # Docker image - can be changed to latest DOCKER_IMAGE="mcp/desktop-commander:latest" CONTAINER_NAME="desktop-commander" # Global flag for verbose output VERBOSE=false print_header() { echo echo -e "${BLUE}██████╗ ███████╗███████╗██╗ ██╗████████╗ ██████╗ ██████╗ ██████╗ ██████╗ ███╗ ███╗███╗ ███╗ █████╗ ███╗ ██╗██████╗ ███████╗██████╗${NC}" echo -e "${BLUE}██╔══██╗██╔════╝██╔════╝██║ ██╔╝╚══██╔══╝██╔═══██╗██╔══██╗ ██╔════╝██╔═══██╗████╗ ████║████╗ ████║██╔══██╗████╗ ██║██╔══██╗██╔════╝██╔══██╗${NC}" echo -e "${BLUE}██║ ██║█████╗ ███████╗█████╔╝ ██║ ██║ ██║██████╔╝ ██║ ██║ ██║██╔████╔██║██╔████╔██║███████║██╔██╗ ██║██║ ██║█████╗ ██████╔╝${NC}" echo -e "${BLUE}██║ ██║██╔══╝ ╚════██║██╔═██╗ ██║ ██║ ██║██╔═══╝ ██║ ██║ ██║██║╚██╔╝██║██║╚██╔╝██║██╔══██║██║╚██╗██║██║ ██║██╔══╝ ██╔══██╗${NC}" echo -e "${BLUE}██████╔╝███████╗███████║██║ ██╗ ██║ ╚██████╔╝██║ ╚██████╗╚██████╔╝██║ ╚═╝ ██║██║ ╚═╝ ██║██║ ██║██║ ╚████║██████╔╝███████╗██║ ██║${NC}" echo -e "${BLUE}╚═════╝ ╚══════╝╚══════╝╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═══╝╚═════╝ ╚══════╝╚═╝ ╚═╝${NC}" echo echo -e "${BLUE}🐳 Docker Installation${NC}" echo print_info "Experiment with AI in secure sandbox environment that won't mess up your main computer" echo } print_success() { echo -e "${GREEN}✅ $1${NC}" } print_error() { echo -e "${RED}❌ Error: $1${NC}" >&2 } print_warning() { echo -e "${YELLOW}⚠️ Warning: $1${NC}" } print_info() { echo -e "${BLUE}ℹ️ $1${NC}" } print_verbose() { if [ "$VERBOSE" = true ]; then echo -e "${BLUE}ℹ️ $1${NC}" fi } # Detect OS detect_os() { case "$OSTYPE" in darwin*) OS="macos" ;; linux*) OS="linux" ;; *) print_error "Unsupported OS: $OSTYPE" ; exit 1 ;; esac } # Get Claude config path based on OS get_claude_config_path() { case "$OS" in "macos") CLAUDE_CONFIG="$HOME/Library/Application Support/Claude/claude_desktop_config.json" ;; "linux") CLAUDE_CONFIG="$HOME/.config/claude/claude_desktop_config.json" ;; esac } # Check if Docker is available check_docker() { while true; do if ! command -v docker >/dev/null 2>&1; then print_error "Docker is not installed or not found" echo print_error "Please install Docker first:" case "$OS" in "macos") print_error "• Download Docker Desktop: https://www.docker.com/products/docker-desktop/" ;; "linux") print_error "• Install Docker Engine: https://docs.docker.com/engine/install/" ;; esac echo echo -n "Press Enter when Docker Desktop is running or Ctrl+C to exit: " read -r continue fi if ! docker info >/dev/null 2>&1; then print_error "Docker is installed but not running" echo print_error "Please start Docker Desktop and try again" echo echo -n "Press Enter when Docker Desktop is running or Ctrl+C to exit: " read -r continue fi # If we get here, Docker is working break done print_success "Docker is available and running" } # Pull the Docker image pull_docker_image() { print_info "Pulling latest Docker image (this may take a moment)..." if docker pull "$DOCKER_IMAGE"; then print_success "Docker image ready: $DOCKER_IMAGE" else print_error "Failed to pull Docker image" print_info "Check your internet connection and Docker Hub access" exit 1 fi } # Ask user which folders to mount ask_for_folders() { echo echo -e "${BLUE}📁 Folder Access Setup${NC}" print_info "By default, Desktop Commander will have access to your user folder:" print_info "📂 $HOME" echo echo -n "Press Enter to accept user folder access or 'y' to customize: " read -r response FOLDERS=() if [[ $response =~ ^[Yy]$ ]]; then # Custom folder selection echo print_info "Custom folder selection:" echo -n "Mount your complete home directory ($HOME)? [Y/n]: " read -r home_response case "$home_response" in [nN]|[nN][oO]) print_info "Skipping home directory" ;; *) FOLDERS+=("$HOME") print_success "Added home directory access" ;; esac # Ask for additional folders echo print_info "Add extra folders outside home directory (optional):" while true; do echo -n "Enter folder path (or Enter to finish): " read -r custom_dir if [ -z "$custom_dir" ]; then break fi custom_dir="${custom_dir/#\~/$HOME}" if [ -d "$custom_dir" ]; then FOLDERS+=("$custom_dir") print_success "Added: $custom_dir" else echo -n "Folder doesn't exist. Add anyway? [y/N]: " read -r add_anyway if [[ $add_anyway =~ ^[Yy]$ ]]; then FOLDERS+=("$custom_dir") print_info "Added: $custom_dir (will create if needed)" fi fi done if [ ${#FOLDERS[@]} -eq 0 ]; then echo print_warning "⚠️ No folders selected - Desktop Commander will have NO file access" echo print_info "This means:" echo " • Desktop Commander cannot read or write any files on your computer" echo " • It cannot help with coding projects, file management, or document editing" echo " • It will only work for system commands and package installation" echo " • This makes Desktop Commander much less useful than intended" echo print_info "You probably want to share at least some folder to work with files" print_info "Most users share their home directory: $HOME" echo echo -n "Continue with NO file access? [y/N]: " read -r confirm if [[ ! $confirm =~ ^[Yy]$ ]]; then print_info "Restarting folder selection..." ask_for_folders return fi print_warning "Proceeding with no file access - Desktop Commander will be limited" fi else # Default: use home directory FOLDERS+=("$HOME") print_success "Using default access to your user folder" fi } # Setup essential volumes for maximum persistence setup_persistent_volumes() { print_verbose "🔧 Setting up persistent development environment" # Essential volumes that cover everything a developer needs ESSENTIAL_VOLUMES=( "dc-system:/usr" # All system packages, binaries, libraries "dc-home:/root" # User configs, dotfiles, SSH keys, git config "dc-workspace:/workspace" # Development files and projects "dc-packages:/var" # Package databases, caches, logs ) for volume in "${ESSENTIAL_VOLUMES[@]}"; do volume_name=$(echo "$volume" | cut -d':' -f1) if ! docker volume inspect "$volume_name" >/dev/null 2>&1; then docker volume create "$volume_name" >/dev/null 2>&1 fi done print_verbose "Persistent environment ready - your tools will survive restarts" } # Build Docker run arguments build_docker_args() { print_verbose "Building Docker configuration..." # Start with base arguments (use --rm so containers auto-remove after each use) DOCKER_ARGS=("run" "-i" "--rm") # Add essential persistent volumes for volume in "${ESSENTIAL_VOLUMES[@]}"; do DOCKER_ARGS+=("-v" "$volume") done # Add user folder mounts with absolute path structure for folder in "${FOLDERS[@]}"; do # Remove leading /Users/username or /home/username and keep absolute structure if [[ "$folder" =~ ^/Users/[^/]+(/.+)$ ]]; then # Mac: /Users/john/projects/data → /home/projects/data absolute_path="${BASH_REMATCH[1]}" DOCKER_ARGS+=("-v" "$folder:/home$absolute_path") elif [[ "$folder" =~ ^/home/[^/]+(/.+)$ ]]; then # Linux: /home/john/projects/data → /home/projects/data absolute_path="${BASH_REMATCH[1]}" DOCKER_ARGS+=("-v" "$folder:/home$absolute_path") else # Fallback for other paths - use basename folder_name=$(basename "$folder") DOCKER_ARGS+=("-v" "$folder:/home/$folder_name") fi done # Add the image DOCKER_ARGS+=("$DOCKER_IMAGE") print_verbose "Docker configuration ready" print_verbose "Essential volumes: ${#ESSENTIAL_VOLUMES[@]} volumes" print_verbose "Mounted folders: ${#FOLDERS[@]} folders" print_verbose "Container mode: Auto-remove after each use (--rm)" } # Update Claude desktop config update_claude_config() { print_verbose "Updating Claude Desktop configuration..." # Create config directory if it doesn't exist CONFIG_DIR=$(dirname "$CLAUDE_CONFIG") if [[ ! -d "$CONFIG_DIR" ]]; then mkdir -p "$CONFIG_DIR" print_verbose "Created config directory: $CONFIG_DIR" fi # Create config if it doesn't exist if [[ ! -f "$CLAUDE_CONFIG" ]]; then echo '{"mcpServers": {}}' > "$CLAUDE_CONFIG" print_verbose "Created new Claude config file" fi # Convert DOCKER_ARGS array to JSON format ARGS_JSON="[" for i in "${!DOCKER_ARGS[@]}"; do if [[ $i -gt 0 ]]; then ARGS_JSON+=", " fi ARGS_JSON+="\"${DOCKER_ARGS[$i]}\"" done ARGS_JSON+="]" # Use Python to update JSON (preserves existing MCP servers) python3 -c " import json import sys config_path = '$CLAUDE_CONFIG' docker_args = $ARGS_JSON try: with open(config_path, 'r') as f: config = json.load(f) except: config = {'mcpServers': {}} if 'mcpServers' not in config: config['mcpServers'] = {} # Configure to use docker run with essential volumes config['mcpServers']['desktop-commander'] = { 'command': 'docker', 'args': docker_args } with open(config_path, 'w') as f: json.dump(config, f, indent=2) print('Successfully updated Claude config') " || { print_error "Failed to update Claude config with Python" exit 1 } print_verbose "Updated Claude config: $CLAUDE_CONFIG" print_verbose "Desktop Commander will be available as 'desktop-commander' in Claude" } # Test the persistent setup test_persistence() { print_verbose "Testing persistent container setup..." print_verbose "Testing essential volumes with a temporary container..." # Test that essential paths are available for persistence if docker "${DOCKER_ARGS[@]}" /bin/bash -c " echo 'Testing persistence paths...' mkdir -p /workspace/test echo 'test-data' > /workspace/test/file.txt && echo 'Workspace persistence: OK' touch /root/.test_config && echo 'Home persistence: OK' echo 'Container test completed successfully' " >/dev/null 2>&1; then print_verbose "Essential persistence test passed" print_verbose "Volumes are working correctly" else print_verbose "Some persistence tests had issues (might still work)" fi } # Show container management commands show_management_info() { echo print_success "🎉 Installation successfully completed! Thank you for using Desktop Commander!" echo print_info "How it works:" echo "• Desktop Commander runs in isolated containers" echo "• Your development tools and configs persist between uses" echo "• Each command creates a fresh, clean container" echo print_info "🤔 Need help or have feedback? Happy to jump on a quick call:" echo " https://calendar.app.google/SHMNZN5MJznJWC5A7" echo print_info "💬 Join our community: https://discord.com/invite/kQ27sNnZr7" echo print_info "💡 If you broke the Docker container or need a fresh start:" echo "• Run: $0 --reset && $0" echo "• This will reset everything and reinstall from scratch" } # Reset all persistent data reset_persistence() { echo print_warning "This will remove ALL persistent container data!" echo "This includes:" echo " • All installed packages and software" echo " • All user configurations and settings" echo " • All development projects in /workspace" echo " • All package caches and databases" echo print_info "Your mounted folders will NOT be affected." echo read -p "Are you sure you want to reset everything? [y/N]: " -r case "$REPLY" in [yY]|[yY][eE][sS]) print_info "Cleaning up containers and volumes..." # Stop and remove any containers that might be using our volumes print_verbose "Stopping any running Desktop Commander containers..." docker ps -q --filter "ancestor=$DOCKER_IMAGE" | xargs -r docker stop >/dev/null 2>&1 || true docker ps -a -q --filter "ancestor=$DOCKER_IMAGE" | xargs -r docker rm >/dev/null 2>&1 || true # Also try by container name if it exists docker stop "$CONTAINER_NAME" >/dev/null 2>&1 || true docker rm "$CONTAINER_NAME" >/dev/null 2>&1 || true print_info "Removing persistent volumes..." local volumes=("dc-system" "dc-home" "dc-workspace" "dc-packages") local failed_volumes=() for volume in "${volumes[@]}"; do if docker volume rm "$volume" >/dev/null 2>&1; then print_success "✅ Removed volume: $volume" else failed_volumes+=("$volume") print_warning "⚠️ Volume $volume is still in use or doesn't exist" fi done # If some volumes failed, try harder cleanup if [ ${#failed_volumes[@]} -gt 0 ]; then print_info "Attempting force cleanup of remaining volumes..." # Remove ALL containers that might be holding references (more aggressive) docker container prune -f >/dev/null 2>&1 || true for volume in "${failed_volumes[@]}"; do if docker volume rm "$volume" >/dev/null 2>&1; then print_success "✅ Force removed volume: $volume" else print_error "❌ Could not remove volume: $volume" print_info "Manual cleanup needed: docker volume rm $volume" fi done fi print_success "🎉 Persistent data reset complete!" echo print_info "Run the installer again to create a fresh environment" ;; *) print_info "Reset cancelled" ;; esac } # Show status of current setup show_status() { echo print_header # Check essential volumes local volumes=("dc-system" "dc-home" "dc-workspace" "dc-packages") local volumes_found=0 echo "Essential volumes status:" for volume in "${volumes[@]}"; do if docker volume inspect "$volume" >/dev/null 2>&1; then local mountpoint mountpoint=$(docker volume inspect "$volume" --format '{{.Mountpoint}}' 2>/dev/null || echo "unknown") local size size=$(sudo du -sh "$mountpoint" 2>/dev/null | cut -f1 || echo "unknown") echo " ✅ $volume ($size)" ((volumes_found++)) else echo " ❌ $volume (missing)" fi done echo echo "Status Summary:" echo " Essential volumes: $volumes_found/4 found" echo " Container mode: Auto-remove (--rm)" echo " Persistence: Data stored in volumes" echo if [ "$volumes_found" -eq 4 ]; then echo "✅ Ready to use with Claude!" echo "Each command creates a fresh container that uses your persistent volumes." elif [ "$volumes_found" -gt 0 ]; then echo "⚠️ Some volumes missing - may need to reinstall" else echo "🚀 Run the installer to create your persistent volumes" fi } # Try to restart Claude automatically restart_claude() { print_info "Attempting to restart Claude..." case "$OS" in macos) # Kill Claude if running if pgrep -f "Claude" > /dev/null; then killall "Claude" 2>/dev/null || true sleep 2 print_info "Stopped Claude" fi # Try to start Claude if command -v open &> /dev/null; then if open -a "Claude" 2>/dev/null; then print_success "Claude restarted successfully" else print_warning "Could not auto-start Claude. Please start it manually." fi else print_warning "Could not auto-restart Claude. Please start it manually." fi ;; linux) # Kill Claude if running if pgrep -f "claude" > /dev/null; then pkill -f "claude" 2>/dev/null || true sleep 2 print_info "Stopped Claude" fi # Try to start Claude if command -v claude &> /dev/null; then if claude &>/dev/null & disown; then print_success "Claude restarted successfully" else print_warning "Could not auto-start Claude. Please start it manually." fi else print_warning "Could not auto-restart Claude. Please start it manually." fi ;; esac } # Help message show_help() { print_header echo "Usage: $0 [OPTION]" echo echo "Options:" echo " (no args) Interactive installation" echo " --verbose Show detailed technical output" echo " --reset Remove all persistent data" echo " --status Show current status" echo " --help Show this help" echo echo "Creates a persistent development container using 4 essential volumes:" echo " • dc-system: System packages and binaries (/usr)" echo " • dc-home: User configurations (/root)" echo " • dc-workspace: Development projects (/workspace)" echo " • dc-packages: Package databases and caches (/var)" echo echo "This covers 99% of development persistence needs with simple management." echo } # Main execution logic case "${1:-}" in --reset) print_header reset_persistence exit 0 ;; --status) show_status exit 0 ;; --help) show_help exit 0 ;; --verbose) VERBOSE=true # Continue to main installation flow ;; ""|--install) # Main installation flow ;; *) print_error "Unknown option: $1" echo "Use --help for usage information" exit 1 ;; esac # Main installation flow print_header detect_os print_success "Detected OS: $OS" get_claude_config_path print_info "Claude config path: $CLAUDE_CONFIG" check_docker pull_docker_image ask_for_folders setup_persistent_volumes build_docker_args update_claude_config test_persistence restart_claude echo print_success "✅ Claude has been restarted (if possible)" print_info "Desktop Commander is available as 'desktop-commander' in Claude" echo print_info "Next steps: Install anything you want - it will persist!" echo "• Global packages: npm install -g typescript" echo "• User configs: git config, SSH keys, .bashrc" show_management_info