@staticpayload/gemini-mcp 1.0.0 → 1.1.0

package/.env.example

@@ -0,0 +1,17 @@
+# Google Cloud Project Configuration
+PROJECT_ID=your-gcp-project-id
+
+# Vertex AI Locations
+LOCATION_GA=us-central1
+LOCATION_PREVIEW=global
+
+# Model Selection
+MODEL_GA=gemini-2.0-flash-001
+MODEL_PREVIEW=gemini-2.0-flash-exp-001
+
+# Gemini CLI Configuration Directory (sandbox)
+GEMINI_CONFIG_DIR=./sandbox/.gemini
+
+# MCP Server Configuration
+MCP_SERVER_PATH=./src/index.js
+MCP_SERVER_NAME=gemini-mcp-local

package/GEMINI_SETUP.md

@@ -0,0 +1,108 @@
+# Gemini CLI Autonomous Setup
+
+Automated configuration for running Gemini CLI with Vertex AI authentication and no interactive prompts.
+
+## Quick Start
+
+1. **Copy environment template:**
+   ```bash
+   cp .env.example .env
+   ```
+
+2. **Edit `.env` with your values:**
+   ```bash
+   PROJECT_ID=your-gcp-project-id
+   LOCATION_GA=us-central1
+   LOCATION_PREVIEW=global
+   MODEL_GA=gemini-2.0-flash-001
+   MODEL_PREVIEW=gemini-2.0-flash-exp-001
+   ```
+
+3. **Authenticate with gcloud:**
+   ```bash
+   gcloud auth application-default login
+   ```
+
+4. **Run setup:**
+   ```bash
+   ./setup-gemini.sh
+   ```
+
+5. **Use Gemini:**
+   ```bash
+   ./run-gemini.sh
+   ```
+
+## What It Does
+
+- ✅ Configures Vertex AI authentication (no API keys)
+- ✅ Disables all permission prompts (autonomous mode)
+- ✅ Routes GA models to regional endpoints
+- ✅ Routes Preview models to global endpoint
+- ✅ Integrates local MCP server
+- ✅ Uses sandbox directory to avoid macOS permission issues
+
+## Configuration Files
+
+After running `setup-gemini.sh`:
+
+```
+sandbox/.gemini/
+├── settings.json         # Main Gemini CLI config
+├── model-router.json     # Model routing rules
+└── README.md            # Configuration details
+```
+
+## Autonomous Permissions
+
+All tools enabled without prompts:
+- File operations (read/write/delete)
+- Shell command execution
+- Web fetching
+
+## Model Selection
+
+**GA Model (regional):**
+```bash
+./run-gemini.sh -m gemini-2.0-flash-001
+```
+
+**Preview Model (global):**
+```bash
+./run-gemini.sh -m gemini-2.0-flash-exp-001
+```
+
+## Environment Variables
+
+| Variable | Description | Example |
+|----------|-------------|---------|
+| `PROJECT_ID` | GCP project ID | `my-project-123` |
+| `LOCATION_GA` | Region for GA models | `us-central1` |
+| `LOCATION_PREVIEW` | Location for preview | `global` |
+| `MODEL_GA` | Default GA model | `gemini-2.0-flash-001` |
+| `MODEL_PREVIEW` | Preview model | `gemini-2.0-flash-exp-001` |
+| `GEMINI_CONFIG_DIR` | Config directory | `./sandbox/.gemini` |
+| `MCP_SERVER_PATH` | Local MCP server | `./src/index.js` |
+
+## Troubleshooting
+
+**Authentication error:**
+```bash
+gcloud auth application-default login
+gcloud config set project YOUR_PROJECT_ID
+```
+
+**Permission denied:**
+```bash
+chmod +x setup-gemini.sh run-gemini.sh
+```
+
+**MCP server not found:**
+Check `MCP_SERVER_PATH` in `.env` points to valid file.
+
+## Security Notes
+
+- `.env` contains sensitive data (gitignored)
+- Uses gcloud application-default credentials
+- No API keys stored in config files
+- Sandbox directory isolated from system config

package/README.md

@@ -7,7 +7,7 @@
 
 <h1 align="center">
   <br>
-  ✦ gemini-cli-mcp
+  ✦ @staticpayload/gemini-mcp
   <br>
 </h1>
 
@@ -20,6 +20,7 @@
   <a href="#-tools">Tools</a> •
   <a href="#-usage">Usage</a> •
   <a href="#-configuration">Configuration</a> •
+  <a href="#-autonomous-setup">Autonomous Setup</a> •
   <a href="#-how-it-works">How It Works</a>
 </p>
 
@@ -34,7 +35,7 @@
 │                    │                                            │
 │                    ▼                                            │
 │   ┌─────────────────────────────────────┐                       │
-│   │        gemini-cli-mcp               │                       │
+│   │     @staticpayload/gemini-mcp       │                       │
 │   │   ┌─────────┐ ┌─────────┐ ┌───────┐ │                       │
 │   │   │ prompt  │ │ models  │ │  raw  │ │   ◄── MCP Tools       │
 │   │   └────┬────┘ └────┬────┘ └───┬───┘ │                       │
@@ -98,7 +99,7 @@ gemini
 ### Run the MCP Server
 
 ```bash
-npx gemini-cli-mcp
+npx @staticpayload/gemini-mcp
 ```
 
 That's it. The server starts and waits for MCP connections via stdio.
@@ -145,7 +146,7 @@ Add to your Claude configuration (`~/.claude/config.json`):
   "mcpServers": {
     "gemini": {
       "command": "npx",
-      "args": ["gemini-cli-mcp"]
+      "args": ["@staticpayload/gemini-mcp"]
     }
   }
 }
@@ -154,7 +155,7 @@ Add to your Claude configuration (`~/.claude/config.json`):
 ### With Claude CLI
 
 ```bash
-claude mcp add gemini -- npx gemini-cli-mcp
+claude mcp add gemini -- npx @staticpayload/gemini-mcp
 ```
 
 ### With Cursor / Windsurf
@@ -165,7 +166,7 @@ Add to your MCP settings:
 {
   "gemini": {
     "command": "npx",
-    "args": ["gemini-cli-mcp"]
+    "args": ["@staticpayload/gemini-mcp"]
   }
 }
 ```
@@ -195,6 +196,40 @@ gcloud auth                ← Application default credentials
 
 ---
 
+## 🤖 Autonomous Setup
+
+For production deployments with **Vertex AI authentication** and **zero interactive prompts**, use the automated setup:
+
+```bash
+# 1. Copy environment template
+cp .env.example .env
+
+# 2. Edit .env with your GCP project
+# PROJECT_ID=your-gcp-project-id
+
+# 3. Authenticate with gcloud
+gcloud auth application-default login
+
+# 4. Run automated setup
+./setup-gemini.sh
+
+# 5. Use Gemini autonomously
+./run-gemini.sh
+```
+
+**Features:**
+- ✅ Vertex AI authentication (no API keys)
+- ✅ No permission prompts for file/shell/web operations
+- ✅ GA/Preview model routing
+- ✅ MCP server integration
+- ✅ Sandbox directory (avoids macOS permission issues)
+
+**See [GEMINI_SETUP.md](./GEMINI_SETUP.md) for complete documentation.**
+
+---
+
+---
+
 ## 🔬 How It Works
 
 ```
@@ -216,7 +251,7 @@ The server is a thin translation layer—all heavy lifting happens in Gemini CLI
 ## 🏗️ Architecture
 
 ```
-gemini-cli-mcp/
+@staticpayload/gemini-mcp/
 ├── src/
 │   └── index.js      # MCP server (single file, ~300 lines)
 ├── package.json      # npm package with bin entry

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@staticpayload/gemini-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server that bridges Google's Gemini CLI to any MCP-compatible AI assistant",
   "type": "module",
   "main": "src/index.js",
@@ -43,6 +43,9 @@
   "files": [
     "src/**/*",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    ".env.example",
+    "setup-gemini.sh",
+    "GEMINI_SETUP.md"
   ]
 }

package/setup-gemini.sh

@@ -0,0 +1,310 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# ============================================================================
+# Gemini CLI Autonomous Configuration Setup
+# ============================================================================
+# This script configures Gemini CLI to run fully autonomously with:
+# - Vertex AI authentication (no API keys)
+# - No interactive permission prompts
+# - Support for GA and Preview models
+# - Custom MCP server integration
+# - Sandbox directory to avoid macOS permission issues
+# ============================================================================
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+log_info() {
+    echo -e "${GREEN}[INFO]${NC} $1"
+}
+
+log_warn() {
+    echo -e "${YELLOW}[WARN]${NC} $1"
+}
+
+log_error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+}
+
+# ============================================================================
+# Load Configuration from .env
+# ============================================================================
+
+if [ ! -f .env ]; then
+    log_error ".env file not found. Copy .env.example to .env and configure it."
+    exit 1
+fi
+
+# Load environment variables
+set -a
+source .env
+set +a
+
+# Validate required variables
+REQUIRED_VARS=(
+    "PROJECT_ID"
+    "LOCATION_GA"
+    "LOCATION_PREVIEW"
+    "MODEL_GA"
+    "MODEL_PREVIEW"
+    "GEMINI_CONFIG_DIR"
+)
+
+for var in "${REQUIRED_VARS[@]}"; do
+    if [ -z "${!var:-}" ]; then
+        log_error "Required variable $var is not set in .env"
+        exit 1
+    fi
+done
+
+log_info "Configuration loaded from .env"
+
+# ============================================================================
+# Setup Sandbox Directory
+# ============================================================================
+
+log_info "Creating sandbox directory: $GEMINI_CONFIG_DIR"
+mkdir -p "$GEMINI_CONFIG_DIR"
+
+# ============================================================================
+# Generate Gemini CLI Settings
+# ============================================================================
+
+SETTINGS_FILE="$GEMINI_CONFIG_DIR/settings.json"
+
+log_info "Generating Gemini CLI settings: $SETTINGS_FILE"
+
+cat > "$SETTINGS_FILE" <<EOF
+{
+  "auth": {
+    "method": "vertexai"
+  },
+  "vertexai": {
+    "projectId": "${PROJECT_ID}",
+    "location": "${LOCATION_GA}"
+  },
+  "model": "${MODEL_GA}",
+  "tools": {
+    "fileOperations": {
+      "enabled": true,
+      "requirePermission": false
+    },
+    "shellExecution": {
+      "enabled": true,
+      "requirePermission": false
+    },
+    "webFetch": {
+      "enabled": true,
+      "requirePermission": false
+    }
+  },
+  "mcpServers": {}
+}
+EOF
+
+log_info "Settings file created with autonomous permissions"
+
+# ============================================================================
+# Generate Model Router Configuration
+# ============================================================================
+
+ROUTER_FILE="$GEMINI_CONFIG_DIR/model-router.json"
+
+log_info "Generating model router: $ROUTER_FILE"
+
+cat > "$ROUTER_FILE" <<EOF
+{
+  "models": {
+    "${MODEL_GA}": {
+      "location": "${LOCATION_GA}",
+      "type": "ga"
+    },
+    "${MODEL_PREVIEW}": {
+      "location": "${LOCATION_PREVIEW}",
+      "type": "preview"
+    }
+  },
+  "defaultModel": "${MODEL_GA}"
+}
+EOF
+
+log_info "Model router configured for GA and Preview models"
+
+# ============================================================================
+# Configure MCP Server (if path provided)
+# ============================================================================
+
+if [ -n "${MCP_SERVER_PATH:-}" ] && [ -f "${MCP_SERVER_PATH}" ]; then
+    log_info "Configuring MCP server: ${MCP_SERVER_NAME:-gemini-mcp}"
+    
+    # Update settings.json with MCP server
+    cat > "$SETTINGS_FILE" <<EOF
+{
+  "auth": {
+    "method": "vertexai"
+  },
+  "vertexai": {
+    "projectId": "${PROJECT_ID}",
+    "location": "${LOCATION_GA}"
+  },
+  "model": "${MODEL_GA}",
+  "tools": {
+    "fileOperations": {
+      "enabled": true,
+      "requirePermission": false
+    },
+    "shellExecution": {
+      "enabled": true,
+      "requirePermission": false
+    },
+    "webFetch": {
+      "enabled": true,
+      "requirePermission": false
+    }
+  },
+  "mcpServers": {
+    "${MCP_SERVER_NAME:-gemini-mcp}": {
+      "command": "node",
+      "args": ["$(pwd)/${MCP_SERVER_PATH}"],
+      "env": {}
+    }
+  }
+}
+EOF
+    
+    log_info "MCP server integrated into Gemini CLI configuration"
+else
+    log_warn "MCP_SERVER_PATH not set or file not found, skipping MCP integration"
+fi
+
+# ============================================================================
+# Generate Helper Scripts
+# ============================================================================
+
+# Script to run Gemini with sandbox config
+GEMINI_WRAPPER="./run-gemini.sh"
+
+log_info "Creating Gemini wrapper script: $GEMINI_WRAPPER"
+
+cat > "$GEMINI_WRAPPER" <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Load .env
+if [ -f .env ]; then
+    set -a
+    source .env
+    set +a
+fi
+
+# Export Vertex AI environment
+export GOOGLE_GENAI_USE_VERTEXAI=true
+export GOOGLE_CLOUD_PROJECT="${PROJECT_ID}"
+export GOOGLE_CLOUD_LOCATION="${LOCATION_GA}"
+
+# Point Gemini to sandbox config
+export GEMINI_CONFIG_DIR="${GEMINI_CONFIG_DIR}"
+
+# Run Gemini CLI
+exec gemini "$@"
+EOF
+
+chmod +x "$GEMINI_WRAPPER"
+
+log_info "Gemini wrapper created: $GEMINI_WRAPPER"
+
+# ============================================================================
+# Generate README for Configuration
+# ============================================================================
+
+CONFIG_README="$GEMINI_CONFIG_DIR/README.md"
+
+cat > "$CONFIG_README" <<EOF
+# Gemini CLI Autonomous Configuration
+
+This directory contains Gemini CLI configuration for autonomous operation.
+
+## Configuration Files
+
+- \`settings.json\` — Main Gemini CLI settings
+- \`model-router.json\` — Model routing for GA vs Preview
+
+## Settings
+
+| Setting | Value |
+|---------|-------|
+| Project ID | \`${PROJECT_ID}\` |
+| GA Location | \`${LOCATION_GA}\` |
+| Preview Location | \`${LOCATION_PREVIEW}\` |
+| GA Model | \`${MODEL_GA}\` |
+| Preview Model | \`${MODEL_PREVIEW}\` |
+
+## Autonomous Permissions
+
+All tools are enabled without permission prompts:
+- ✅ File operations
+- ✅ Shell execution
+- ✅ Web fetch
+
+## Usage
+
+Run Gemini with this configuration:
+
+\`\`\`bash
+./run-gemini.sh
+\`\`\`
+
+Or manually:
+
+\`\`\`bash
+export GEMINI_CONFIG_DIR="${GEMINI_CONFIG_DIR}"
+export GOOGLE_GENAI_USE_VERTEXAI=true
+export GOOGLE_CLOUD_PROJECT="${PROJECT_ID}"
+gemini
+\`\`\`
+
+## MCP Server
+
+${MCP_SERVER_PATH:+MCP server configured: \`${MCP_SERVER_NAME}\`}
+${MCP_SERVER_PATH:+Path: \`${MCP_SERVER_PATH}\`}
+EOF
+
+log_info "Configuration README created: $CONFIG_README"
+
+# ============================================================================
+# Verify gcloud Authentication
+# ============================================================================
+
+log_info "Verifying gcloud authentication..."
+
+if ! gcloud auth application-default print-access-token &>/dev/null; then
+    log_warn "gcloud application-default credentials not found"
+    log_info "Run: gcloud auth application-default login"
+else
+    log_info "gcloud authentication verified ✓"
+fi
+
+# ============================================================================
+# Summary
+# ============================================================================
+
+echo ""
+log_info "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+log_info "Gemini CLI Configuration Complete!"
+log_info "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "Configuration directory: ${GEMINI_CONFIG_DIR}"
+echo "Wrapper script: ${GEMINI_WRAPPER}"
+echo ""
+echo "To run Gemini:"
+echo "  ${GEMINI_WRAPPER}"
+echo ""
+echo "To use a preview model:"
+echo "  ${GEMINI_WRAPPER} -m ${MODEL_PREVIEW}"
+echo ""
+log_info "All tools are enabled without permission prompts"
+echo ""