Improve installation UX with SSH authentication support

- Updated install.sh to prefer SSH over HTTPS authentication
- Added automatic SSH detection with fallback to HTTPS if needed
- Added ZIP file download option for systems without git
- Updated documentation to provide both SSH and HTTPS examples
- Enhanced README with information about the installation options
- Fixed the pip install command to work with SSH authentication

Author: randomm

README.md

@@ -22,6 +22,11 @@ Files-DB-MCP is a local vector database system that provides LLM coding agents w
 curl -fsSL https://raw.githubusercontent.com/randomm/files-db-mcp/main/install.sh | bash
 ```
 
+The installation script automatically:
+- Tries to use SSH for GitHub authentication if available
+- Falls back to HTTPS if SSH is not set up
+- Provides a ZIP download option if git is not installed
+
 ### Usage
 
 After installation, just run in any project directory:

docs/installation_guide.md

@@ -25,8 +25,10 @@ The Docker Compose installation is the simplest and most reliable way to run Fil
 ### Quick Install
 
 ```bash
-# Clone the repository
-git clone https://github.com/randomm/files-db-mcp.git
+# Clone the repository (using SSH, recommended if you have SSH keys set up)
+git clone [email protected]:randomm/files-db-mcp.git
+# Or using HTTPS
+# git clone https://github.com/randomm/files-db-mcp.git
 cd files-db-mcp
 
 # Start the services
@@ -57,8 +59,10 @@ Files-DB-MCP can be installed as a global CLI tool for easy access from any proj
 # Install the latest stable version
 pip install files-db-mcp
 
-# Or install the development version
+# Or install the development version (HTTPS)
 pip install git+https://github.com/randomm/files-db-mcp.git
+# Or if you prefer SSH
+# pip install git+ssh://[email protected]/randomm/files-db-mcp.git
 ```
 
 ### Usage
@@ -96,8 +100,10 @@ Options:
 For advanced users who want to install from source:
 
 ```bash
-# Clone the repository
-git clone https://github.com/randomm/files-db-mcp.git
+# Clone the repository (using SSH, recommended if you have SSH keys set up)
+git clone [email protected]:randomm/files-db-mcp.git
+# Or using HTTPS
+# git clone https://github.com/randomm/files-db-mcp.git
 cd files-db-mcp
 
 # Create and activate a virtual environment
@@ -116,8 +122,10 @@ python -m src.main
 For developers who want to contribute to Files-DB-MCP:
 
 ```bash
-# Clone the repository
-git clone https://github.com/randomm/files-db-mcp.git
+# Clone the repository (using SSH, recommended if you have SSH keys set up)
+git clone [email protected]:randomm/files-db-mcp.git
+# Or using HTTPS
+# git clone https://github.com/randomm/files-db-mcp.git
 cd files-db-mcp
 
 # Create and activate a virtual environment

install.sh

@@ -50,14 +50,57 @@ if command -v git >/dev/null 2>&1; then
         git pull
     else
         echo "Cloning repository..."
-        git clone https://github.com/randomm/files-db-mcp.git "$INSTALL_DIR"
+        
+        # Try cloning with SSH first (preferred for users with SSH keys)
+        if ssh -T [email protected] 2>&1 | grep -q "successfully authenticated"; then
+            echo "Using SSH for GitHub authentication..."
+            git clone [email protected]:randomm/files-db-mcp.git "$INSTALL_DIR"
+        else
+            # Ask if user wants to try HTTPS instead
+            echo "SSH authentication to GitHub may not be set up."
+            read -p "Do you want to use HTTPS instead? (y/n) " -n 1 -r
+            echo
+            if [[ $REPLY =~ ^[Yy]$ ]]; then
+                git clone https://github.com/randomm/files-db-mcp.git "$INSTALL_DIR"
+            else
+                echo "To clone with SSH, ensure your SSH key is added to your GitHub account."
+                echo "See: https://docs.github.com/en/authentication/connecting-to-github-with-ssh"
+                exit 1
+            fi
+        fi
     fi
 else
-    # Option 2: Download zip file (placeholder)
-    echo "Git not found, downloading files directly..."
-    # This would be implemented with curl or wget to download a zip file
-    echo "Not implemented yet, please install git"
-    exit 1
+    # Option 2: Download zip file
+    echo "Git not found, downloading repository as zip file..."
+    
+    if command -v curl >/dev/null 2>&1; then
+        echo "Downloading with curl..."
+        curl -L https://github.com/randomm/files-db-mcp/archive/refs/heads/main.zip -o "$INSTALL_DIR/main.zip"
+        
+        if command -v unzip >/dev/null 2>&1; then
+            unzip -o "$INSTALL_DIR/main.zip" -d "$INSTALL_DIR-temp"
+            mv "$INSTALL_DIR-temp"/*/* "$INSTALL_DIR"
+            rm -rf "$INSTALL_DIR-temp" "$INSTALL_DIR/main.zip"
+        else
+            echo "Error: unzip command not found. Please install unzip."
+            exit 1
+        fi
+    elif command -v wget >/dev/null 2>&1; then
+        echo "Downloading with wget..."
+        wget https://github.com/randomm/files-db-mcp/archive/refs/heads/main.zip -O "$INSTALL_DIR/main.zip"
+        
+        if command -v unzip >/dev/null 2>&1; then
+            unzip -o "$INSTALL_DIR/main.zip" -d "$INSTALL_DIR-temp"
+            mv "$INSTALL_DIR-temp"/*/* "$INSTALL_DIR"
+            rm -rf "$INSTALL_DIR-temp" "$INSTALL_DIR/main.zip"
+        else
+            echo "Error: unzip command not found. Please install unzip."
+            exit 1
+        fi
+    else
+        echo "Error: Neither curl nor wget found. Please install git, curl, or wget."
+        exit 1
+    fi
 fi
 
 # Create alias in ~/.bashrc or ~/.zshrc