Gemini MCP Server with Smart Tool Intelligence

Welcome to the Gemini MCP Server, the first MCP server with Smart Tool Intelligence - a revolutionary self-learning system that adapts to your preferences and improves over time. This comprehensive platform provides 7 AI-powered tools with automatic prompt enhancement and context awareness.

🚀 Features Overview

🤖 7 AI-Powered Tools

• Image Generation - Create images from text prompts using Gemini 2.0 Flash
• Image Editing - Edit existing images with natural language instructions
• Chat - Interactive conversations with context-aware responses
• Audio Transcription - Convert audio to text with optional verbatim mode
• Code Execution - Run Python code in a secure sandbox environment
• Video Analysis - Analyze video content for summaries, transcripts, and insights
• Image Analysis - Extract objects, text, and detailed descriptions from images

🧠 Smart Tool Intelligence System (First in MCP Ecosystem)

• Self-Learning - Automatically learns from successful interactions
• Context Detection - Recognizes consciousness research, coding, debugging contexts
• Pattern Recognition - Identifies usage patterns and user preferences
• Prompt Enhancement - Refines prompts for better AI model performance
• Persistent Memory - Stores learned preferences across sessions
• Automatic Migration - Seamlessly upgrades preference storage

📦 Quick Start

Installation

git clone https://github.com/Garblesnarff/gemini-mcp-server.git
cd gemini-mcp-server
npm install

Configuration

1. Get your Gemini API key from Google AI Studio
2. Copy the environment template:

   cp .env.example .env
   

3. Edit .env and add your API key:

   GEMINI_API_KEY=your_actual_api_key_here
   OUTPUT_DIR=/path/to/your/output/directory  # Optional
   DEBUG=false  # Optional
   

Running the Server

npm start
# or for development with debug logging:
npm run dev

Integration with Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

{
  \"mcpServers\": {
    \"gemini\": {
      \"command\": \"node\",
      \"args\": [\"/path/to/gemini-mcp-server/gemini-server.js\"],
      \"env\": {
        \"GEMINI_API_KEY\": \"your_api_key_here\"
      }
    }
  }
}

🛠️ Tool Reference

1. Image Generation (generate_image)

Generate images from text descriptions using Gemini 2.0 Flash.

Parameters:

• prompt (string, required) - Description of the image to generate
• context (string, optional) - Context for Smart Tool Intelligence enhancement

Example:

{
  \"prompt\": \"A serene mountain landscape at sunset with vibrant colors\",
  \"context\": \"artistic\"
}

Returns:

{
  \"content\": [{
    \"type\": \"text\",
    \"text\": \"Generated a beautiful mountain landscape image.\"
  }, {