## Major Features Added ### 🎯 Dynamic Configuration System - **Environment-aware model selection**: DEFAULT_MODEL with 'pro'/'flash' shortcuts - **Configurable thinking modes**: DEFAULT_THINKING_MODE_THINKDEEP for extended reasoning - **All tool schemas now dynamic**: Show actual current defaults instead of hardcoded values - **Enhanced setup workflow**: Copy from .env.example with smart customization ### 🔧 Model & Thinking Configuration - **Smart model resolution**: Support both shortcuts ('pro', 'flash') and full model names - **Thinking mode optimization**: Only apply thinking budget to models that support it - **Flash model compatibility**: Works without thinking config, still beneficial via system prompts - **Dynamic schema descriptions**: Tool parameters show current environment values ### 🚀 Enhanced Developer Experience - **Fail-fast Docker setup**: GEMINI_API_KEY required upfront in docker-compose - **Comprehensive startup logging**: Shows current model and thinking mode defaults - **Enhanced get_version tool**: Reports all dynamic configuration values - **Better .env documentation**: Clear token consumption details and model options ### 🧪 Comprehensive Testing - **Live model validation**: New simulator test validates Pro vs Flash thinking behavior - **Dynamic configuration tests**: Verify environment variable overrides work correctly - **Complete test coverage**: All 139 unit tests pass, including new model config tests ### 📋 Configuration Files Updated - **docker-compose.yml**: Fail-fast API key validation, thinking mode support - **setup-docker.sh**: Copy from .env.example instead of manual creation - **.env.example**: Detailed documentation with token consumption per thinking mode - **.gitignore**: Added test-setup/ for cleanup ### 🛠 Technical Improvements - **Removed setup.py**: Fully Docker-based deployment (no longer needed) - **REDIS_URL smart defaults**: Auto-configured for Docker, still configurable for dev - **All tools updated**: Consistent dynamic model parameter descriptions - **Enhanced error handling**: Better model resolution and validation ## Breaking Changes - Removed setup.py (Docker-only deployment) - Model parameter descriptions now show actual defaults (dynamic) ## Migration Guide - Update .env files using new .env.example format - Use 'pro'/'flash' shortcuts or full model names - Set DEFAULT_THINKING_MODE_THINKDEEP for custom thinking depth 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
198 lines
6.8 KiB
Bash
Executable File
198 lines
6.8 KiB
Bash
Executable File
#!/bin/bash
|
|
|
|
# Exit on any error, undefined variables, and pipe failures
|
|
set -euo pipefail
|
|
|
|
# Modern Docker setup script for Gemini MCP Server with Redis
|
|
# This script sets up the complete Docker environment including Redis for conversation threading
|
|
|
|
echo "🚀 Setting up Gemini MCP Server with Docker Compose..."
|
|
echo ""
|
|
|
|
# Get the current working directory (absolute path)
|
|
CURRENT_DIR=$(pwd)
|
|
|
|
# Check if .env already exists
|
|
if [ -f .env ]; then
|
|
echo "⚠️ .env file already exists! Updating if needed..."
|
|
echo ""
|
|
else
|
|
# Copy from .env.example and customize
|
|
if [ ! -f .env.example ]; then
|
|
echo "❌ .env.example file not found! This file should exist in the project directory."
|
|
exit 1
|
|
fi
|
|
|
|
# Copy .env.example to .env
|
|
cp .env.example .env
|
|
echo "✅ Created .env from .env.example"
|
|
|
|
# Customize the API key if it's set in environment
|
|
if [ -n "$GEMINI_API_KEY" ]; then
|
|
# Replace the placeholder API key with the actual value
|
|
if command -v sed >/dev/null 2>&1; then
|
|
sed -i.bak "s/your_gemini_api_key_here/$GEMINI_API_KEY/" .env && rm .env.bak
|
|
echo "✅ Updated .env with existing GEMINI_API_KEY from environment"
|
|
else
|
|
echo "⚠️ Found GEMINI_API_KEY in environment, but sed not available. Please update .env manually."
|
|
fi
|
|
else
|
|
echo "⚠️ GEMINI_API_KEY not found in environment. Please edit .env and add your API key."
|
|
fi
|
|
|
|
# Update WORKSPACE_ROOT to use current user's home directory
|
|
if command -v sed >/dev/null 2>&1; then
|
|
sed -i.bak "s|WORKSPACE_ROOT=/Users/your-username|WORKSPACE_ROOT=$HOME|" .env && rm .env.bak
|
|
echo "✅ Updated WORKSPACE_ROOT to $HOME"
|
|
fi
|
|
echo "✅ Created .env file with Redis configuration"
|
|
echo ""
|
|
fi
|
|
|
|
# Check if Docker and Docker Compose are installed
|
|
if ! command -v docker &> /dev/null; then
|
|
echo "❌ Docker is not installed. Please install Docker first."
|
|
echo " Visit: https://docs.docker.com/get-docker/"
|
|
exit 1
|
|
fi
|
|
|
|
if ! command -v docker-compose &> /dev/null && ! docker compose version &> /dev/null; then
|
|
echo "❌ Docker Compose is not installed. Please install Docker Compose first."
|
|
echo " Visit: https://docs.docker.com/compose/install/"
|
|
exit 1
|
|
fi
|
|
|
|
# Check if Docker daemon is running
|
|
if ! docker info &> /dev/null; then
|
|
echo "❌ Docker daemon is not running. Please start Docker."
|
|
exit 1
|
|
fi
|
|
|
|
# Use modern docker compose syntax if available, fall back to docker-compose
|
|
COMPOSE_CMD="docker compose"
|
|
if ! docker compose version &> /dev/null; then
|
|
COMPOSE_CMD="docker-compose"
|
|
fi
|
|
|
|
echo "🛠️ Building and starting services..."
|
|
echo ""
|
|
|
|
# Stop and remove existing containers
|
|
echo " - Stopping existing containers..."
|
|
$COMPOSE_CMD down --remove-orphans >/dev/null 2>&1 || true
|
|
|
|
# Clean up any old containers with different naming patterns
|
|
OLD_CONTAINERS_FOUND=false
|
|
|
|
# Check for old Gemini MCP container
|
|
if docker ps -a --format "{{.Names}}" | grep -q "^gemini-mcp-server-gemini-mcp-1$" 2>/dev/null || false; then
|
|
OLD_CONTAINERS_FOUND=true
|
|
echo " - Cleaning up old container: gemini-mcp-server-gemini-mcp-1"
|
|
docker stop gemini-mcp-server-gemini-mcp-1 >/dev/null 2>&1 || true
|
|
docker rm gemini-mcp-server-gemini-mcp-1 >/dev/null 2>&1 || true
|
|
fi
|
|
|
|
# Check for old Redis container
|
|
if docker ps -a --format "{{.Names}}" | grep -q "^gemini-mcp-server-redis-1$" 2>/dev/null || false; then
|
|
OLD_CONTAINERS_FOUND=true
|
|
echo " - Cleaning up old container: gemini-mcp-server-redis-1"
|
|
docker stop gemini-mcp-server-redis-1 >/dev/null 2>&1 || true
|
|
docker rm gemini-mcp-server-redis-1 >/dev/null 2>&1 || true
|
|
fi
|
|
|
|
# Check for old image
|
|
if docker images --format "{{.Repository}}:{{.Tag}}" | grep -q "^gemini-mcp-server-gemini-mcp:latest$" 2>/dev/null || false; then
|
|
OLD_CONTAINERS_FOUND=true
|
|
echo " - Cleaning up old image: gemini-mcp-server-gemini-mcp:latest"
|
|
docker rmi gemini-mcp-server-gemini-mcp:latest >/dev/null 2>&1 || true
|
|
fi
|
|
|
|
# Only show cleanup messages if something was actually cleaned up
|
|
|
|
# Build and start services
|
|
echo " - Building Gemini MCP Server image..."
|
|
if $COMPOSE_CMD build --no-cache >/dev/null 2>&1; then
|
|
echo "✅ Docker image built successfully!"
|
|
else
|
|
echo "❌ Failed to build Docker image. Run '$COMPOSE_CMD build' manually to see errors."
|
|
exit 1
|
|
fi
|
|
|
|
echo " - Starting Redis and MCP services... please wait"
|
|
if $COMPOSE_CMD up -d >/dev/null 2>&1; then
|
|
echo "✅ Services started successfully!"
|
|
else
|
|
echo "❌ Failed to start services. Run '$COMPOSE_CMD up -d' manually to see errors."
|
|
exit 1
|
|
fi
|
|
|
|
# Wait for services to be healthy
|
|
echo " - Waiting for Redis to be ready..."
|
|
sleep 3
|
|
|
|
# Check service status
|
|
if $COMPOSE_CMD ps --format table | grep -q "Up" 2>/dev/null || false; then
|
|
echo "✅ All services are running!"
|
|
else
|
|
echo "⚠️ Some services may not be running. Check with: $COMPOSE_CMD ps"
|
|
fi
|
|
|
|
echo ""
|
|
echo "📋 Service Status:"
|
|
$COMPOSE_CMD ps --format table
|
|
|
|
echo ""
|
|
echo "🔄 Next steps:"
|
|
if grep -q "your-gemini-api-key-here" .env 2>/dev/null || false; then
|
|
echo "1. Edit .env and replace 'your-gemini-api-key-here' with your actual Gemini API key"
|
|
echo "2. Restart services: $COMPOSE_CMD restart"
|
|
echo "3. Copy the configuration below to your Claude Desktop config:"
|
|
else
|
|
echo "1. Copy the configuration below to your Claude Desktop config:"
|
|
fi
|
|
|
|
echo ""
|
|
echo "===== CLAUDE DESKTOP CONFIGURATION ====="
|
|
echo "{"
|
|
echo " \"mcpServers\": {"
|
|
echo " \"gemini\": {"
|
|
echo " \"command\": \"docker\","
|
|
echo " \"args\": ["
|
|
echo " \"exec\","
|
|
echo " \"-i\","
|
|
echo " \"gemini-mcp-server\","
|
|
echo " \"python\","
|
|
echo " \"server.py\""
|
|
echo " ]"
|
|
echo " }"
|
|
echo " }"
|
|
echo "}"
|
|
echo "==========================================="
|
|
echo ""
|
|
echo "===== CLAUDE CODE CLI CONFIGURATION ====="
|
|
echo "# Add the MCP server via Claude Code CLI:"
|
|
echo "claude mcp add gemini -s user -- docker exec -i gemini-mcp-server python server.py"
|
|
echo ""
|
|
echo "# List your MCP servers to verify:"
|
|
echo "claude mcp list"
|
|
echo ""
|
|
echo "# Remove if needed:"
|
|
echo "claude mcp remove gemini -s user"
|
|
echo "==========================================="
|
|
echo ""
|
|
|
|
echo "📁 Config file locations:"
|
|
echo " macOS: ~/Library/Application Support/Claude/claude_desktop_config.json"
|
|
echo ' Windows (WSL): /mnt/c/Users/USERNAME/AppData/Roaming/Claude/claude_desktop_config.json'
|
|
echo ""
|
|
|
|
echo "🔧 Useful commands:"
|
|
echo " Start services: $COMPOSE_CMD up -d"
|
|
echo " Stop services: $COMPOSE_CMD down"
|
|
echo " View logs: $COMPOSE_CMD logs -f"
|
|
echo " Restart services: $COMPOSE_CMD restart"
|
|
echo " Service status: $COMPOSE_CMD ps"
|
|
echo ""
|
|
|
|
echo "🗃️ Redis for conversation threading is automatically configured and running!"
|
|
echo " All AI-to-AI conversations will persist between requests." |