From 7db322d494fd1bc69329db852aadad82005b803d Mon Sep 17 00:00:00 2001
From: Fahad <fahad@2doapp.com>
Date: Mon, 9 Jun 2025 05:32:10 +0400
Subject: [PATCH] docs: improve quickstart instructions with explicit clone
 step
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add step 2 for cloning the repository with clear examples
- Provide separate macOS/Linux and Windows path examples
- Add explicit instructions to replace YOUR_USERNAME
- Include note about Windows double backslashes
- Make instructions crystal clear for new users

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 README.md | 54 +++++++++++++++++++++++++++++++++++++++++++++---------
 1 file changed, 45 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index ad4ee47..7a90454 100644
--- a/README.md
+++ b/README.md
@@ -19,18 +19,36 @@ This server makes Gemini your development sidekick, handling what Claude can't o
 ### 1. Get a Gemini API Key
 Visit [Google AI Studio](https://makersuite.google.com/app/apikey) and generate an API key. For best results with Gemini 2.5 Pro, use a paid API key as the free tier has limited access to the latest models.
 
-### 2. Install via Claude Desktop Config
+### 2. Clone the Repository
+Clone this repository to a location on your computer:
 
-Add to your `claude_desktop_config.json`:
+```bash
+# Example: Clone to your home directory
+cd ~
+git clone https://github.com/BeehiveInnovations/gemini-mcp-server.git
 
-**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
-**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+# The server is now at: ~/gemini-mcp-server
+```
 
+**Note the full path** - you'll need it in the next step:
+- **macOS/Linux**: `/Users/YOUR_USERNAME/gemini-mcp-server`
+- **Windows**: `C:\Users\YOUR_USERNAME\gemini-mcp-server`
+
+### 3. Configure Claude Desktop
+Add the server to your `claude_desktop_config.json`:
+
+**Find your config file:**
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+**Add this configuration** (replace with YOUR actual paths):
+
+**macOS/Linux:**
 ```json
 {
   "mcpServers": {
     "gemini": {
-      "command": "/absolute/path/to/gemini-mcp-server/run_gemini.sh",
+      "command": "/Users/YOUR_USERNAME/gemini-mcp-server/run_gemini.sh",
       "env": {
         "GEMINI_API_KEY": "your-gemini-api-key-here"
       }
@@ -39,18 +57,36 @@ Add to your `claude_desktop_config.json`:
 }
 ```
 
-**Windows users**: Use `run_gemini.bat` instead of `run_gemini.sh`
+**Windows:**
+```json
+{
+  "mcpServers": {
+    "gemini": {
+      "command": "C:\\Users\\YOUR_USERNAME\\gemini-mcp-server\\run_gemini.bat",
+      "env": {
+        "GEMINI_API_KEY": "your-gemini-api-key-here"
+      }
+    }
+  }
+}
+```
 
-### 3. Restart Claude Desktop
+**Important**: 
+- Replace `YOUR_USERNAME` with your actual username
+- Use the full absolute path where you cloned the repository
+- Windows users: Note the double backslashes `\\` in the path
 
-### 4. Connect to Claude Code
+### 4. Restart Claude Desktop
+Completely quit and restart Claude Desktop for the changes to take effect.
+
+### 5. Connect to Claude Code
 
 To use the server in Claude Code, run:
 ```bash
 claude mcp add-from-claude-desktop -s user
 ```
 
-### 5. Start Using It!
+### 6. Start Using It!
 
 Just ask Claude naturally:
 - "Use gemini to think deeper about this architecture design"