gemini-bridge 1.0.1__py3-none-any.whl → 1.0.2__py3-none-any.whl

{gemini_bridge-1.0.1.dist-info → gemini_bridge-1.0.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemini-bridge
-Version: 1.0.1
+Version: 1.0.2
 Summary: Lightweight MCP server bridging Claude Code to Google's Gemini AI via official CLI
 Author-email: Shelakh <info@shelakh.com>
 License-Expression: MIT
@@ -29,7 +29,9 @@ Dynamic: license-file
 ![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)
 ![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)
 ![MCP Compatible](https://img.shields.io/badge/MCP-compatible-green.svg)
-A lightweight MCP (Model Context Protocol) server that enables Claude Code to interact with Google's Gemini AI through the official CLI. Designed for simplicity, reliability, and seamless integration.
+![Gemini CLI](https://img.shields.io/badge/Gemini-CLI-blue.svg)
+
+A lightweight MCP (Model Context Protocol) server that enables AI coding assistants to interact with Google's Gemini AI through the official CLI. Works with Claude Code, Cursor, VS Code, and other MCP-compatible clients. Designed for simplicity, reliability, and seamless integration.
 
 ## ✨ Features
 
@@ -39,6 +41,7 @@ A lightweight MCP (Model Context Protocol) server that enables Claude Code to in
 - **Production Ready**: Robust error handling with configurable 60-second timeouts
 - **Minimal Dependencies**: Only requires `mcp>=1.0.0` and Gemini CLI
 - **Easy Deployment**: Support for both uvx and traditional pip installation
+- **Universal MCP Compatibility**: Works with any MCP-compatible AI coding assistant
 
 ## 🚀 Quick Start
 
@@ -95,6 +98,313 @@ pip install -e .
 claude mcp add gemini-bridge-dev -s user -- python -m src
 ```
 
+## 🌐 Multi-Client Support
+
+**Gemini Bridge works with any MCP-compatible AI coding assistant** - the same server supports multiple clients through different configuration methods.
+
+### Supported MCP Clients
+- **Claude Code** ✅ (Default)
+- **Cursor** ✅
+- **VS Code** ✅
+- **Windsurf** ✅
+- **Cline** ✅
+- **Void** ✅
+- **Cherry Studio** ✅
+- **Augment** ✅
+- **Roo Code** ✅
+- **Zencoder** ✅
+- **Any MCP-compatible client** ✅
+
+### Configuration Examples
+
+<details>
+<summary><strong>Claude Code</strong> (Default)</summary>
+
+```bash
+# Recommended installation
+claude mcp add gemini-bridge -s user -- uvx gemini-bridge
+
+# Development installation
+claude mcp add gemini-bridge-dev -s user -- python -m src
+```
+
+</details>
+
+<details>
+<summary><strong>Cursor</strong></summary>
+
+**Global Configuration** (`~/.cursor/mcp.json`):
+```json
+{
+  "mcpServers": {
+    "gemini-bridge": {
+      "command": "uvx",
+      "args": ["gemini-bridge"],
+      "env": {}
+    }
+  }
+}
+```
+
+**Project-Specific** (`.cursor/mcp.json` in your project):
+```json
+{
+  "mcpServers": {
+    "gemini-bridge": {
+      "command": "uvx",
+      "args": ["gemini-bridge"],
+      "env": {}
+    }
+  }
+}
+```
+
+Go to: `Settings` → `Cursor Settings` → `MCP` → `Add new global MCP server`
+
+</details>
+
+<details>
+<summary><strong>VS Code</strong></summary>
+
+**Configuration** (`.vscode/mcp.json` in your workspace):
+```json
+{
+  "servers": {
+    "gemini-bridge": {
+      "type": "stdio",
+      "command": "uvx",
+      "args": ["gemini-bridge"]
+    }
+  }
+}
+```
+
+**Alternative: Through Extensions**
+1. Open Extensions view (Ctrl+Shift+X)
+2. Search for MCP extensions
+3. Add custom server with command: `uvx gemini-bridge`
+
+</details>
+
+<details>
+<summary><strong>Windsurf</strong></summary>
+
+Add to your Windsurf MCP configuration:
+```json
+{
+  "mcpServers": {
+    "gemini-bridge": {
+      "command": "uvx",
+      "args": ["gemini-bridge"],
+      "env": {}
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>Cline</strong> (VS Code Extension)</summary>
+
+1. Open Cline and click **MCP Servers** in the top navigation
+2. Select **Installed** tab → **Advanced MCP Settings**
+3. Add to `cline_mcp_settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "gemini-bridge": {
+      "command": "uvx",
+      "args": ["gemini-bridge"],
+      "env": {}
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>Void</strong></summary>
+
+Go to: `Settings` → `MCP` → `Add MCP Server`
+
+```json
+{
+  "mcpServers": {
+    "gemini-bridge": {
+      "command": "uvx",
+      "args": ["gemini-bridge"],
+      "env": {}
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>Cherry Studio</strong></summary>
+
+1. Navigate to **Settings → MCP Servers → Add Server**
+2. Fill in the server details:
+   - **Name**: `gemini-bridge`
+   - **Type**: `STDIO`
+   - **Command**: `uvx`
+   - **Arguments**: `["gemini-bridge"]`
+3. Save the configuration
+
+</details>
+
+<details>
+<summary><strong>Augment</strong></summary>
+
+**Using the UI:**
+1. Click hamburger menu → **Settings** → **Tools**
+2. Click **+ Add MCP** button
+3. Enter command: `uvx gemini-bridge`
+4. Name: **Gemini Bridge**
+
+**Manual Configuration:**
+```json
+"augment.advanced": { 
+  "mcpServers": [ 
+    { 
+      "name": "gemini-bridge", 
+      "command": "uvx", 
+      "args": ["gemini-bridge"],
+      "env": {}
+    }
+  ]
+}
+```
+
+</details>
+
+<details>
+<summary><strong>Roo Code</strong></summary>
+
+1. Go to **Settings → MCP Servers → Edit Global Config**
+2. Add to `mcp_settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "gemini-bridge": {
+      "command": "uvx",
+      "args": ["gemini-bridge"],
+      "env": {}
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>Zencoder</strong></summary>
+
+1. Go to Zencoder menu (...) → **Tools** → **Add Custom MCP**
+2. Add configuration:
+
+```json
+{
+  "command": "uvx",
+  "args": ["gemini-bridge"],
+  "env": {}
+}
+```
+
+3. Hit the **Install** button
+
+</details>
+
+<details>
+<summary><strong>Alternative Installation Methods</strong></summary>
+
+**For pip-based installations:**
+```json
+{
+  "command": "gemini-bridge",
+  "args": [],
+  "env": {}
+}
+```
+
+**For development/local testing:**
+```json
+{
+  "command": "python",
+  "args": ["-m", "src"],
+  "env": {},
+  "cwd": "/path/to/gemini-bridge"
+}
+```
+
+**For npm-style installation** (if needed):
+```json
+{
+  "command": "npx",
+  "args": ["gemini-bridge"],
+  "env": {}
+}
+```
+
+</details>
+
+### Universal Usage
+
+Once configured with any client, use the same two tools:
+
+1. **Ask general questions**: "What authentication patterns are used in this codebase?"
+2. **Analyze specific files**: "Review these auth files for security issues"
+
+**The server implementation is identical** - only the client configuration differs!
+
+## ⚙️ Configuration
+
+### Timeout Configuration
+
+By default, Gemini Bridge uses a 60-second timeout for all CLI operations. For longer queries (large files, complex analysis), you can configure a custom timeout using the `GEMINI_BRIDGE_TIMEOUT` environment variable.
+
+**Example configurations:**
+
+<details>
+<summary><strong>Claude Code</strong></summary>
+
+```bash
+# Add with custom timeout (120 seconds)
+claude mcp add gemini-bridge -s user --env GEMINI_BRIDGE_TIMEOUT=120 -- uvx gemini-bridge
+```
+
+</details>
+
+<details>
+<summary><strong>Manual Configuration (mcp_settings.json)</strong></summary>
+
+```json
+{
+  "mcpServers": {
+    "gemini-bridge": {
+      "command": "uvx",
+      "args": ["gemini-bridge"],
+      "env": {
+        "GEMINI_BRIDGE_TIMEOUT": "120"
+      }
+    }
+  }
+}
+```
+
+</details>
+
+**Timeout Options:**
+- **Default**: 60 seconds (if not configured)
+- **Range**: Any positive integer (seconds)
+- **Recommended**: 120-300 seconds for large file analysis
+- **Invalid values**: Fall back to 60 seconds with warning
+
 ## 🛠️ Available Tools
 
 ### `consult_gemini`

gemini_bridge-1.0.2.dist-info/RECORD

@@ -0,0 +1,9 @@
+gemini_bridge-1.0.2.dist-info/licenses/LICENSE,sha256=yTz_R8ocWu64Eubxr6vdZCKRS0dB_Pi3RbjUNn4qPxQ,1063
+src/__init__.py,sha256=XwIQ60BQ748HOAFYiRvDP4HWUonSZfGNvNv6-YnuKgc,190
+src/__main__.py,sha256=12FoIYCXYYKu2_BYX1GS_h9E9qO41Q26B8zedRIDPBs,149
+src/mcp_server.py,sha256=vYykaYMSNtkwOB94VZPvnJ2fuBZkKgnqcoYL12ZM20k,7722
+gemini_bridge-1.0.2.dist-info/METADATA,sha256=UF7tWNaTxoCL6unvjkWKnjwp8cFzrz1X6k3dDfWKOu4,13798
+gemini_bridge-1.0.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+gemini_bridge-1.0.2.dist-info/entry_points.txt,sha256=ygWf0B23Gygq8mW_GzPx8rxIA19RR_RH4RG2I15lU3E,43
+gemini_bridge-1.0.2.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+gemini_bridge-1.0.2.dist-info/RECORD,,

src/__init__.py

@@ -5,5 +5,5 @@ Version 1.0.0 - Production ready, radically simplified.
 
 from .mcp_server import main
 
-__version__ = "1.0.1"
+__version__ = "1.0.2"
 __all__ = ["main"]

src/mcp_server.py

@@ -1,11 +1,12 @@
 #!/usr/bin/env python3
 """
 Gemini MCP Server - Simple CLI Bridge
-Version 1.0.0
+Version 1.0.2
 A minimal MCP server to interface with Gemini AI via the gemini CLI.
 Created by @shelakh/elyin
 """
 
+import logging
 import os
 import shutil
 import subprocess
@@ -40,6 +41,29 @@ def _normalize_model_name(model: Optional[str]) -> str:
     return "gemini-2.5-flash"
 
 
+def _get_timeout() -> int:
+    """
+    Get the timeout value from environment variable GEMINI_BRIDGE_TIMEOUT.
+    Defaults to 60 seconds if not set or invalid.
+    
+    Returns:
+        Timeout value in seconds (positive integer)
+    """
+    timeout_str = os.getenv("GEMINI_BRIDGE_TIMEOUT")
+    if not timeout_str:
+        return 60
+    
+    try:
+        timeout = int(timeout_str)
+        if timeout <= 0:
+            logging.warning("Invalid GEMINI_BRIDGE_TIMEOUT value '%s' (must be positive). Using default 60 seconds.", timeout_str)
+            return 60
+        return timeout
+    except ValueError:
+        logging.warning("Invalid GEMINI_BRIDGE_TIMEOUT value '%s' (must be integer). Using default 60 seconds.", timeout_str)
+        return 60
+
+
 def execute_gemini_simple(query: str, directory: str = ".", model: Optional[str] = None) -> str:
     """
     Execute gemini CLI command for simple queries without file attachments.
@@ -65,13 +89,14 @@ def execute_gemini_simple(query: str, directory: str = ".", model: Optional[str]
     cmd = ["gemini", "-m", selected_model]
     
     # Execute CLI command - simple timeout, no retries
+    timeout = _get_timeout()
     try:
         result = subprocess.run(
             cmd,
             cwd=directory,
             capture_output=True,
             text=True,
-            timeout=60,
+            timeout=timeout,
             input=query
         )
         
@@ -81,7 +106,7 @@ def execute_gemini_simple(query: str, directory: str = ".", model: Optional[str]
             return f"Gemini CLI Error: {result.stderr.strip()}"
             
     except subprocess.TimeoutExpired:
-        return "Error: Gemini CLI command timed out after 60 seconds"
+        return f"Error: Gemini CLI command timed out after {timeout} seconds"
     except Exception as e:
         return f"Error executing Gemini CLI: {str(e)}"
 
@@ -136,13 +161,14 @@ def execute_gemini_with_files(query: str, directory: str = ".", files: Optional[
     stdin_content = "\n\n".join(file_contents) + "\n\n" + query
     
     # Execute CLI command - simple timeout, no retries
+    timeout = _get_timeout()
     try:
         result = subprocess.run(
             cmd,
             cwd=directory,
             capture_output=True,
             text=True,
-            timeout=60,
+            timeout=timeout,
             input=stdin_content
         )
         
@@ -152,7 +178,7 @@ def execute_gemini_with_files(query: str, directory: str = ".", files: Optional[
             return f"Gemini CLI Error: {result.stderr.strip()}"
             
     except subprocess.TimeoutExpired:
-        return "Error: Gemini CLI command timed out after 60 seconds"
+        return f"Error: Gemini CLI command timed out after {timeout} seconds"
     except Exception as e:
         return f"Error executing Gemini CLI: {str(e)}"
 

gemini_bridge-1.0.1.dist-info/RECORD

@@ -1,9 +0,0 @@
-gemini_bridge-1.0.1.dist-info/licenses/LICENSE,sha256=yTz_R8ocWu64Eubxr6vdZCKRS0dB_Pi3RbjUNn4qPxQ,1063
-src/__init__.py,sha256=4DkVQMA4JJ2eUEDNpi3sMJh94joDfaG_52p7Dro6cQI,190
-src/__main__.py,sha256=12FoIYCXYYKu2_BYX1GS_h9E9qO41Q26B8zedRIDPBs,149
-src/mcp_server.py,sha256=SGdrmNMvpCvJseSvvMlBGvDS71RkwWS7yM4JnSPg_Yg,6871
-gemini_bridge-1.0.1.dist-info/METADATA,sha256=C6gVIb1Z2OHpAPHA8F2_Ub42E6InC3ROjZTYEfqjONI,7825
-gemini_bridge-1.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-gemini_bridge-1.0.1.dist-info/entry_points.txt,sha256=ygWf0B23Gygq8mW_GzPx8rxIA19RR_RH4RG2I15lU3E,43
-gemini_bridge-1.0.1.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
-gemini_bridge-1.0.1.dist-info/RECORD,,