mcp-server-gemini 1.1.0

package/dist/enhanced-stdio-server.js

@@ -0,0 +1,1164 @@
+#!/usr/bin/env node
+import { GoogleGenAI } from '@google/genai';
+import { createInterface } from 'readline';
+// Increase max buffer size for large images (10MB)
+if (process.stdin.setEncoding) {
+    process.stdin.setEncoding('utf8');
+}
+// Available Gemini models as of July 2025
+const GEMINI_MODELS = {
+    // Thinking models (2.5 series) - latest and most capable
+    'gemini-2.5-pro': {
+        description: 'Most capable thinking model, best for complex reasoning and coding',
+        features: ['thinking', 'function_calling', 'json_mode', 'grounding', 'system_instructions'],
+        contextWindow: 2000000, // 2M tokens
+        thinking: true
+    },
+    'gemini-2.5-flash': {
+        description: 'Fast thinking model with best price/performance ratio',
+        features: ['thinking', 'function_calling', 'json_mode', 'grounding', 'system_instructions'],
+        contextWindow: 1000000, // 1M tokens
+        thinking: true
+    },
+    'gemini-2.5-flash-lite': {
+        description: 'Ultra-fast, cost-efficient thinking model for high-throughput tasks',
+        features: ['thinking', 'function_calling', 'json_mode', 'system_instructions'],
+        contextWindow: 1000000,
+        thinking: true
+    },
+    // 2.0 series
+    'gemini-2.0-flash': {
+        description: 'Fast, efficient model with 1M context window',
+        features: ['function_calling', 'json_mode', 'grounding', 'system_instructions'],
+        contextWindow: 1000000
+    },
+    'gemini-2.0-flash-lite': {
+        description: 'Most cost-efficient model for simple tasks',
+        features: ['function_calling', 'json_mode', 'system_instructions'],
+        contextWindow: 1000000
+    },
+    'gemini-2.0-pro-experimental': {
+        description: 'Experimental model with 2M context, excellent for coding',
+        features: ['function_calling', 'json_mode', 'grounding', 'system_instructions'],
+        contextWindow: 2000000
+    },
+    // Legacy models (for compatibility)
+    'gemini-1.5-pro': {
+        description: 'Previous generation pro model',
+        features: ['function_calling', 'json_mode', 'system_instructions'],
+        contextWindow: 2000000
+    },
+    'gemini-1.5-flash': {
+        description: 'Previous generation fast model',
+        features: ['function_calling', 'json_mode', 'system_instructions'],
+        contextWindow: 1000000
+    }
+};
+class EnhancedStdioMCPServer {
+    genAI;
+    conversations = new Map();
+    constructor(apiKey) {
+        this.genAI = new GoogleGenAI({ apiKey });
+        this.setupStdioInterface();
+    }
+    setupStdioInterface() {
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            terminal: false,
+            // Increase max line length for large image data
+            crlfDelay: Infinity
+        });
+        rl.on('line', (line) => {
+            if (line.trim()) {
+                try {
+                    const request = JSON.parse(line);
+                    this.handleRequest(request);
+                }
+                catch (error) {
+                    console.error('Failed to parse message:', error);
+                }
+            }
+        });
+        process.stdin.on('error', (err) => {
+            console.error('stdin error:', err);
+        });
+    }
+    async handleRequest(request) {
+        console.error('Handling request:', request.method);
+        try {
+            let response;
+            switch (request.method) {
+                case 'initialize':
+                    response = {
+                        jsonrpc: '2.0',
+                        id: request.id,
+                        result: {
+                            protocolVersion: '2024-11-05',
+                            serverInfo: {
+                                name: 'mcp-server-gemini-enhanced',
+                                version: '4.1.0'
+                            },
+                            capabilities: {
+                                tools: {},
+                                resources: {},
+                                prompts: {}
+                            }
+                        }
+                    };
+                    break;
+                case 'tools/list':
+                    response = {
+                        jsonrpc: '2.0',
+                        id: request.id,
+                        result: {
+                            tools: this.getAvailableTools()
+                        }
+                    };
+                    break;
+                case 'tools/call':
+                    response = await this.handleToolCall(request);
+                    break;
+                case 'resources/list':
+                    response = {
+                        jsonrpc: '2.0',
+                        id: request.id,
+                        result: {
+                            resources: this.getAvailableResources()
+                        }
+                    };
+                    break;
+                case 'resources/read':
+                    response = await this.handleResourceRead(request);
+                    break;
+                case 'prompts/list':
+                    response = {
+                        jsonrpc: '2.0',
+                        id: request.id,
+                        result: {
+                            prompts: this.getAvailablePrompts()
+                        }
+                    };
+                    break;
+                default:
+                    if (!('id' in request)) {
+                        console.error(`Notification received: ${request.method}`);
+                        return;
+                    }
+                    response = {
+                        jsonrpc: '2.0',
+                        id: request.id,
+                        error: {
+                            code: -32601,
+                            message: 'Method not found'
+                        }
+                    };
+            }
+            this.sendResponse(response);
+        }
+        catch (error) {
+            const errorResponse = {
+                jsonrpc: '2.0',
+                id: request.id,
+                error: {
+                    code: -32603,
+                    message: error instanceof Error ? error.message : 'Internal error'
+                }
+            };
+            this.sendResponse(errorResponse);
+        }
+    }
+    getAvailableTools() {
+        return [
+            {
+                name: 'generate_text',
+                description: 'Generate text using Google Gemini with advanced features',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        prompt: {
+                            type: 'string',
+                            description: 'The prompt to send to Gemini'
+                        },
+                        model: {
+                            type: 'string',
+                            description: 'Specific Gemini model to use',
+                            enum: Object.keys(GEMINI_MODELS),
+                            default: 'gemini-2.5-flash'
+                        },
+                        systemInstruction: {
+                            type: 'string',
+                            description: 'System instruction to guide model behavior'
+                        },
+                        temperature: {
+                            type: 'number',
+                            description: 'Temperature for generation (0-2)',
+                            default: 0.7,
+                            minimum: 0,
+                            maximum: 2
+                        },
+                        maxTokens: {
+                            type: 'number',
+                            description: 'Maximum tokens to generate',
+                            default: 2048
+                        },
+                        topK: {
+                            type: 'number',
+                            description: 'Top-k sampling parameter',
+                            default: 40
+                        },
+                        topP: {
+                            type: 'number',
+                            description: 'Top-p (nucleus) sampling parameter',
+                            default: 0.95
+                        },
+                        jsonMode: {
+                            type: 'boolean',
+                            description: 'Enable JSON mode for structured output',
+                            default: false
+                        },
+                        jsonSchema: {
+                            type: 'object',
+                            description: 'JSON schema for structured output (when jsonMode is true)'
+                        },
+                        grounding: {
+                            type: 'boolean',
+                            description: 'Enable Google Search grounding for up-to-date information',
+                            default: false
+                        },
+                        safetySettings: {
+                            type: 'array',
+                            description: 'Safety settings for content filtering',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    category: {
+                                        type: 'string',
+                                        enum: ['HARM_CATEGORY_HARASSMENT', 'HARM_CATEGORY_HATE_SPEECH', 'HARM_CATEGORY_SEXUALLY_EXPLICIT', 'HARM_CATEGORY_DANGEROUS_CONTENT']
+                                    },
+                                    threshold: {
+                                        type: 'string',
+                                        enum: ['BLOCK_NONE', 'BLOCK_ONLY_HIGH', 'BLOCK_MEDIUM_AND_ABOVE', 'BLOCK_LOW_AND_ABOVE']
+                                    }
+                                }
+                            }
+                        },
+                        conversationId: {
+                            type: 'string',
+                            description: 'ID for maintaining conversation context'
+                        }
+                    },
+                    required: ['prompt']
+                }
+            },
+            {
+                name: 'analyze_image',
+                description: 'Analyze images using Gemini vision capabilities',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        prompt: {
+                            type: 'string',
+                            description: 'Question or instruction about the image'
+                        },
+                        imageUrl: {
+                            type: 'string',
+                            description: 'URL of the image to analyze'
+                        },
+                        imageBase64: {
+                            type: 'string',
+                            description: 'Base64-encoded image data (alternative to URL)'
+                        },
+                        model: {
+                            type: 'string',
+                            description: 'Vision-capable Gemini model',
+                            enum: ['gemini-2.5-pro', 'gemini-2.5-flash', 'gemini-2.0-flash'],
+                            default: 'gemini-2.5-flash'
+                        }
+                    },
+                    required: ['prompt'],
+                    oneOf: [
+                        { required: ['imageUrl'] },
+                        { required: ['imageBase64'] }
+                    ]
+                }
+            },
+            {
+                name: 'count_tokens',
+                description: 'Count tokens for a given text with a specific model',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        text: {
+                            type: 'string',
+                            description: 'Text to count tokens for'
+                        },
+                        model: {
+                            type: 'string',
+                            description: 'Model to use for token counting',
+                            enum: Object.keys(GEMINI_MODELS),
+                            default: 'gemini-2.5-flash'
+                        }
+                    },
+                    required: ['text']
+                }
+            },
+            {
+                name: 'list_models',
+                description: 'List all available Gemini models and their capabilities',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        filter: {
+                            type: 'string',
+                            description: 'Filter models by capability',
+                            enum: ['all', 'thinking', 'vision', 'grounding', 'json_mode']
+                        }
+                    }
+                }
+            },
+            {
+                name: 'embed_text',
+                description: 'Generate embeddings for text using Gemini embedding models',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        text: {
+                            type: 'string',
+                            description: 'Text to generate embeddings for'
+                        },
+                        model: {
+                            type: 'string',
+                            description: 'Embedding model to use',
+                            enum: ['text-embedding-004', 'text-multilingual-embedding-002'],
+                            default: 'text-embedding-004'
+                        }
+                    },
+                    required: ['text']
+                }
+            },
+            {
+                name: 'get_help',
+                description: 'Get help and usage information for the Gemini MCP server',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        topic: {
+                            type: 'string',
+                            description: 'Help topic to get information about',
+                            enum: ['overview', 'tools', 'models', 'parameters', 'examples', 'quick-start'],
+                            default: 'overview'
+                        }
+                    }
+                }
+            }
+        ];
+    }
+    getAvailableResources() {
+        return [
+            {
+                uri: 'gemini://models',
+                name: 'Available Gemini Models',
+                description: 'List of all available Gemini models and their capabilities',
+                mimeType: 'application/json'
+            },
+            {
+                uri: 'gemini://capabilities',
+                name: 'API Capabilities',
+                description: 'Detailed information about Gemini API capabilities',
+                mimeType: 'text/markdown'
+            },
+            {
+                uri: 'gemini://help/usage',
+                name: 'Usage Guide',
+                description: 'Complete guide on using all tools and features',
+                mimeType: 'text/markdown'
+            },
+            {
+                uri: 'gemini://help/parameters',
+                name: 'Parameters Reference',
+                description: 'Detailed documentation of all parameters',
+                mimeType: 'text/markdown'
+            },
+            {
+                uri: 'gemini://help/examples',
+                name: 'Examples',
+                description: 'Example usage patterns for common tasks',
+                mimeType: 'text/markdown'
+            }
+        ];
+    }
+    getAvailablePrompts() {
+        return [
+            {
+                name: 'code_review',
+                description: 'Comprehensive code review with Gemini 2.5 Pro',
+                arguments: [
+                    {
+                        name: 'code',
+                        description: 'Code to review',
+                        required: true
+                    },
+                    {
+                        name: 'language',
+                        description: 'Programming language',
+                        required: false
+                    }
+                ]
+            },
+            {
+                name: 'explain_with_thinking',
+                description: 'Deep explanation using Gemini 2.5 thinking capabilities',
+                arguments: [
+                    {
+                        name: 'topic',
+                        description: 'Topic to explain',
+                        required: true
+                    },
+                    {
+                        name: 'level',
+                        description: 'Explanation level (beginner/intermediate/expert)',
+                        required: false
+                    }
+                ]
+            },
+            {
+                name: 'creative_writing',
+                description: 'Creative writing with style control',
+                arguments: [
+                    {
+                        name: 'prompt',
+                        description: 'Writing prompt',
+                        required: true
+                    },
+                    {
+                        name: 'style',
+                        description: 'Writing style',
+                        required: false
+                    },
+                    {
+                        name: 'length',
+                        description: 'Desired length',
+                        required: false
+                    }
+                ]
+            }
+        ];
+    }
+    async handleToolCall(request) {
+        const { name, arguments: args } = request.params || {};
+        switch (name) {
+            case 'generate_text':
+                return await this.generateText(request.id, args);
+            case 'analyze_image':
+                return await this.analyzeImage(request.id, args);
+            case 'count_tokens':
+                return await this.countTokens(request.id, args);
+            case 'list_models':
+                return this.listModels(request.id, args);
+            case 'embed_text':
+                return await this.embedText(request.id, args);
+            case 'get_help':
+                return this.getHelp(request.id, args);
+            default:
+                return {
+                    jsonrpc: '2.0',
+                    id: request.id,
+                    error: {
+                        code: -32601,
+                        message: `Unknown tool: ${name}`
+                    }
+                };
+        }
+    }
+    async generateText(id, args) {
+        try {
+            const model = args.model || 'gemini-2.5-flash';
+            const modelInfo = GEMINI_MODELS[model];
+            if (!modelInfo) {
+                throw new Error(`Unknown model: ${model}`);
+            }
+            // Build generation config
+            const generationConfig = {
+                temperature: args.temperature || 0.7,
+                maxOutputTokens: args.maxTokens || 2048,
+                topK: args.topK || 40,
+                topP: args.topP || 0.95
+            };
+            // Add JSON mode if requested
+            if (args.jsonMode) {
+                generationConfig.responseMimeType = 'application/json';
+                if (args.jsonSchema) {
+                    generationConfig.responseSchema = args.jsonSchema;
+                }
+            }
+            // Build the request
+            const requestBody = {
+                model,
+                contents: [{
+                        parts: [{
+                                text: args.prompt
+                            }],
+                        role: 'user'
+                    }],
+                generationConfig
+            };
+            // Add system instruction if provided
+            if (args.systemInstruction) {
+                requestBody.systemInstruction = {
+                    parts: [{
+                            text: args.systemInstruction
+                        }]
+                };
+            }
+            // Add safety settings if provided
+            if (args.safetySettings) {
+                requestBody.safetySettings = args.safetySettings;
+            }
+            // Add grounding if requested and supported
+            if (args.grounding && modelInfo.features.includes('grounding')) {
+                requestBody.tools = [{
+                        googleSearch: {}
+                    }];
+            }
+            // Handle conversation context
+            if (args.conversationId) {
+                const history = this.conversations.get(args.conversationId) || [];
+                if (history.length > 0) {
+                    requestBody.contents = [...history, ...requestBody.contents];
+                }
+            }
+            // Call the API using the new SDK format
+            const result = await this.genAI.models.generateContent({
+                model,
+                ...requestBody
+            });
+            const text = result.text || '';
+            // Update conversation history if needed
+            if (args.conversationId) {
+                const history = this.conversations.get(args.conversationId) || [];
+                history.push(...requestBody.contents);
+                history.push({
+                    parts: [{
+                            text: text
+                        }],
+                    role: 'model'
+                });
+                this.conversations.set(args.conversationId, history);
+            }
+            return {
+                jsonrpc: '2.0',
+                id,
+                result: {
+                    content: [{
+                            type: 'text',
+                            text: text
+                        }],
+                    metadata: {
+                        model,
+                        tokensUsed: result.usageMetadata?.totalTokenCount,
+                        candidatesCount: result.candidates?.length || 1,
+                        finishReason: result.candidates?.[0]?.finishReason
+                    }
+                }
+            };
+        }
+        catch (error) {
+            console.error('Error in generateText:', error);
+            return {
+                jsonrpc: '2.0',
+                id,
+                error: {
+                    code: -32603,
+                    message: error instanceof Error ? error.message : 'Internal error'
+                }
+            };
+        }
+    }
+    async analyzeImage(id, args) {
+        try {
+            const model = args.model || 'gemini-2.5-flash';
+            // Validate inputs
+            if (!args.imageUrl && !args.imageBase64) {
+                throw new Error('Either imageUrl or imageBase64 must be provided');
+            }
+            // Prepare image part
+            let imagePart;
+            if (args.imageUrl) {
+                // For URL, we'd need to fetch and convert to base64
+                // For now, we'll just pass the URL as instruction
+                imagePart = {
+                    text: `[Image URL: ${args.imageUrl}]`
+                };
+            }
+            else if (args.imageBase64) {
+                // Log base64 data size for debugging
+                console.error(`Image base64 length: ${args.imageBase64.length}`);
+                // Extract MIME type and data
+                const matches = args.imageBase64.match(/^data:(.+);base64,(.+)$/);
+                if (matches) {
+                    console.error(`MIME type: ${matches[1]}, Data length: ${matches[2].length}`);
+                    imagePart = {
+                        inlineData: {
+                            mimeType: matches[1],
+                            data: matches[2]
+                        }
+                    };
+                }
+                else {
+                    // If no data URI format, assume raw base64
+                    console.error('Raw base64 data detected');
+                    imagePart = {
+                        inlineData: {
+                            mimeType: 'image/jpeg',
+                            data: args.imageBase64
+                        }
+                    };
+                }
+            }
+            const result = await this.genAI.models.generateContent({
+                model,
+                contents: [{
+                        parts: [
+                            { text: args.prompt },
+                            imagePart
+                        ],
+                        role: 'user'
+                    }]
+            });
+            const text = result.text || '';
+            return {
+                jsonrpc: '2.0',
+                id,
+                result: {
+                    content: [{
+                            type: 'text',
+                            text: text
+                        }]
+                }
+            };
+        }
+        catch (error) {
+            console.error('Error in analyzeImage:', error);
+            return {
+                jsonrpc: '2.0',
+                id,
+                error: {
+                    code: -32603,
+                    message: `Image analysis failed: ${error instanceof Error ? error.message : 'Unknown error'}`
+                }
+            };
+        }
+    }
+    async countTokens(id, args) {
+        try {
+            const model = args.model || 'gemini-2.5-flash';
+            const result = await this.genAI.models.countTokens({
+                model,
+                contents: [{
+                        parts: [{
+                                text: args.text
+                            }],
+                        role: 'user'
+                    }]
+            });
+            return {
+                jsonrpc: '2.0',
+                id,
+                result: {
+                    content: [{
+                            type: 'text',
+                            text: `Token count: ${result.totalTokens}`
+                        }],
+                    metadata: {
+                        tokenCount: result.totalTokens,
+                        model
+                    }
+                }
+            };
+        }
+        catch (error) {
+            return {
+                jsonrpc: '2.0',
+                id,
+                error: {
+                    code: -32603,
+                    message: error instanceof Error ? error.message : 'Internal error'
+                }
+            };
+        }
+    }
+    listModels(id, args) {
+        const filter = args?.filter || 'all';
+        let models = Object.entries(GEMINI_MODELS);
+        if (filter !== 'all') {
+            models = models.filter(([_, info]) => {
+                switch (filter) {
+                    case 'thinking':
+                        return 'thinking' in info && info.thinking === true;
+                    case 'vision':
+                        return info.features.includes('function_calling'); // All current models support vision
+                    case 'grounding':
+                        return info.features.includes('grounding');
+                    case 'json_mode':
+                        return info.features.includes('json_mode');
+                    default:
+                        return true;
+                }
+            });
+        }
+        const modelList = models.map(([name, info]) => ({
+            name,
+            ...info
+        }));
+        return {
+            jsonrpc: '2.0',
+            id,
+            result: {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify(modelList, null, 2)
+                    }],
+                metadata: {
+                    count: modelList.length,
+                    filter
+                }
+            }
+        };
+    }
+    async embedText(id, args) {
+        try {
+            const model = args.model || 'text-embedding-004';
+            const result = await this.genAI.models.embedContent({
+                model,
+                contents: args.text
+            });
+            return {
+                jsonrpc: '2.0',
+                id,
+                result: {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                embedding: result.embeddings?.[0]?.values || [],
+                                model
+                            })
+                        }],
+                    metadata: {
+                        model,
+                        dimensions: result.embeddings?.[0]?.values?.length || 0
+                    }
+                }
+            };
+        }
+        catch (error) {
+            return {
+                jsonrpc: '2.0',
+                id,
+                error: {
+                    code: -32603,
+                    message: error instanceof Error ? error.message : 'Internal error'
+                }
+            };
+        }
+    }
+    async handleResourceRead(request) {
+        const uri = request.params?.uri;
+        if (!uri) {
+            return {
+                jsonrpc: '2.0',
+                id: request.id,
+                error: {
+                    code: -32602,
+                    message: 'Missing required parameter: uri'
+                }
+            };
+        }
+        let content = '';
+        let mimeType = 'text/plain';
+        switch (uri) {
+            case 'gemini://models':
+                content = JSON.stringify(GEMINI_MODELS, null, 2);
+                mimeType = 'application/json';
+                break;
+            case 'gemini://capabilities':
+                content = `# Gemini API Capabilities
+
+## Text Generation
+- All models support advanced text generation
+- System instructions for behavior control
+- Temperature, topK, topP for output control
+- Token limits vary by model (1M-2M)
+
+## Thinking Models (2.5 Series)
+- Step-by-step reasoning before responding
+- Better accuracy for complex problems
+- Ideal for coding, analysis, and problem-solving
+
+## JSON Mode
+- Structured output with schema validation
+- Available on all models
+- Ensures consistent response format
+
+## Google Search Grounding
+- Real-time web search integration
+- Available on select models
+- Perfect for current events and facts
+
+## Vision Capabilities
+- Image analysis and understanding
+- Available on most models
+- Supports URLs and base64 images
+
+## Embeddings
+- Semantic text embeddings
+- Multiple models available
+- Multilingual support
+
+## Safety Settings
+- Granular content filtering
+- Customizable thresholds
+- Per-category control
+
+## Conversation Memory
+- Context retention across messages
+- Session-based conversations
+- Ideal for multi-turn interactions`;
+                mimeType = 'text/markdown';
+                break;
+            case 'gemini://help/usage':
+                content = this.getHelpContent('overview') + '\n\n' + this.getHelpContent('tools');
+                mimeType = 'text/markdown';
+                break;
+            case 'gemini://help/parameters':
+                content = this.getHelpContent('parameters');
+                mimeType = 'text/markdown';
+                break;
+            case 'gemini://help/examples':
+                content = this.getHelpContent('examples');
+                mimeType = 'text/markdown';
+                break;
+            default:
+                return {
+                    jsonrpc: '2.0',
+                    id: request.id,
+                    error: {
+                        code: -32602,
+                        message: `Unknown resource: ${uri}`
+                    }
+                };
+        }
+        return {
+            jsonrpc: '2.0',
+            id: request.id,
+            result: {
+                contents: [{
+                        uri,
+                        mimeType,
+                        text: content
+                    }]
+            }
+        };
+    }
+    getHelpContent(topic) {
+        // Extract help content generation to a separate method
+        switch (topic) {
+            case 'overview':
+                return `# Gemini MCP Server Help
+
+Welcome to the Gemini MCP Server v4.1.0! This server provides access to Google's Gemini AI models through Claude Desktop.
+
+## Available Tools
+1. **generate_text** - Generate text with advanced features
+2. **analyze_image** - Analyze images using vision models
+3. **count_tokens** - Count tokens for cost estimation
+4. **list_models** - List all available models
+5. **embed_text** - Generate text embeddings
+6. **get_help** - Get help on using this server
+
+## Quick Start
+- "Use Gemini to explain [topic]"
+- "Analyze this image with Gemini"
+- "List all Gemini models"
+- "Get help on parameters"
+
+## Key Features
+- Latest Gemini 2.5 models with thinking capabilities
+- JSON mode for structured output
+- Google Search grounding for current information
+- System instructions for behavior control
+- Conversation memory for context
+- Safety settings customization
+
+Use "get help on tools" for detailed tool information.`;
+            case 'tools':
+                return `# Available Tools
+
+## 1. generate_text
+Generate text using Gemini models with advanced features.
+
+**Parameters:**
+- prompt (required): Your text prompt
+- model: Choose from gemini-2.5-pro, gemini-2.5-flash, etc.
+- temperature: 0-2 (default 0.7)
+- maxTokens: Max output tokens (default 2048)
+- systemInstruction: Guide model behavior
+- jsonMode: Enable JSON output
+- grounding: Enable Google Search
+- conversationId: Maintain conversation context
+
+**Example:** "Use Gemini 2.5 Pro to explain quantum computing"
+
+## 2. analyze_image
+Analyze images using vision-capable models.
+
+**Parameters:**
+- prompt (required): Question about the image
+- imageUrl OR imageBase64 (required): Image source
+- model: Vision-capable model (default gemini-2.5-flash)
+
+**Example:** "Analyze this architecture diagram"
+
+## 3. count_tokens
+Count tokens for text with a specific model.
+
+**Parameters:**
+- text (required): Text to count
+- model: Model for counting (default gemini-2.5-flash)
+
+**Example:** "Count tokens for this paragraph"
+
+## 4. list_models
+List available models with optional filtering.
+
+**Parameters:**
+- filter: all, thinking, vision, grounding, json_mode
+
+**Example:** "List models with thinking capability"
+
+## 5. embed_text
+Generate embeddings for semantic search.
+
+**Parameters:**
+- text (required): Text to embed
+- model: text-embedding-004 or text-multilingual-embedding-002
+
+**Example:** "Generate embeddings for similarity search"
+
+## 6. get_help
+Get help on using this server.
+
+**Parameters:**
+- topic: overview, tools, models, parameters, examples, quick-start
+
+**Example:** "Get help on parameters"`;
+            case 'parameters':
+                return `# Parameter Reference
+
+## generate_text Parameters
+
+**Required:**
+- prompt (string): Your text prompt
+
+**Optional:**
+- model (string): Model to use (default: gemini-2.5-flash)
+- systemInstruction (string): System prompt for behavior
+- temperature (0-2): Creativity level (default: 0.7)
+- maxTokens (number): Max output tokens (default: 2048)
+- topK (number): Top-k sampling (default: 40)
+- topP (number): Nucleus sampling (default: 0.95)
+- jsonMode (boolean): Enable JSON output
+- jsonSchema (object): JSON schema for validation
+- grounding (boolean): Enable Google Search
+- conversationId (string): Conversation identifier
+- safetySettings (array): Content filtering settings
+
+## Temperature Guide
+- 0.1-0.3: Precise, factual
+- 0.5-0.8: Balanced (default 0.7)
+- 1.0-1.5: Creative
+- 1.5-2.0: Very creative
+
+## JSON Mode Example
+Enable jsonMode and provide jsonSchema:
+{
+  "type": "object",
+  "properties": {
+    "sentiment": {"type": "string"},
+    "score": {"type": "number"}
+  }
+}
+
+## Safety Settings
+Categories: HARASSMENT, HATE_SPEECH, SEXUALLY_EXPLICIT, DANGEROUS_CONTENT
+Thresholds: BLOCK_NONE, BLOCK_ONLY_HIGH, BLOCK_MEDIUM_AND_ABOVE, BLOCK_LOW_AND_ABOVE`;
+            case 'examples':
+                return `# Usage Examples
+
+## Basic Text Generation
+"Use Gemini to explain machine learning"
+
+## With Specific Model
+"Use Gemini 2.5 Pro to write a Python sorting function"
+
+## With Temperature
+"Use Gemini with temperature 1.5 to write a creative story"
+
+## JSON Mode
+"Use Gemini in JSON mode to analyze sentiment and return {sentiment, confidence, keywords}"
+
+## With Grounding
+"Use Gemini with grounding to research latest AI developments"
+
+## System Instructions
+"Use Gemini as a Python tutor to explain decorators"
+
+## Conversation Context
+"Start conversation 'chat-001' about web development"
+"Continue chat-001 and ask about React hooks"
+
+## Image Analysis
+"Analyze this screenshot and describe the UI elements"
+
+## Token Counting
+"Count tokens for this document using gemini-2.5-pro"
+
+## Complex Example
+"Use Gemini 2.5 Pro to review this code with:
+- System instruction: 'You are a security expert'
+- Temperature: 0.3
+- JSON mode with schema for findings
+- Grounding for latest security practices"`;
+            default:
+                return 'Unknown help topic.';
+        }
+    }
+    getHelp(id, args) {
+        const topic = args?.topic || 'overview';
+        let helpContent = '';
+        switch (topic) {
+            case 'overview':
+                helpContent = this.getHelpContent('overview');
+                break;
+            case 'tools':
+                helpContent = this.getHelpContent('tools');
+                break;
+            case 'models':
+                helpContent = `# Available Gemini Models
+
+## Thinking Models (Latest - 2.5 Series)
+**gemini-2.5-pro**
+- Most capable, best for complex reasoning
+- 2M token context window
+- Features: thinking, JSON mode, grounding, system instructions
+
+**gemini-2.5-flash** ⭐ Recommended
+- Best balance of speed and capability
+- 1M token context window
+- Features: thinking, JSON mode, grounding, system instructions
+
+**gemini-2.5-flash-lite**
+- Ultra-fast, cost-efficient
+- 1M token context window
+- Features: thinking, JSON mode, system instructions
+
+## Standard Models (2.0 Series)
+**gemini-2.0-flash**
+- Fast and efficient
+- 1M token context window
+- Features: JSON mode, grounding, system instructions
+
+**gemini-2.0-flash-lite**
+- Most cost-efficient
+- 1M token context window
+- Features: JSON mode, system instructions
+
+**gemini-2.0-pro-experimental**
+- Excellent for coding
+- 2M token context window
+- Features: JSON mode, grounding, system instructions
+
+## Model Selection Guide
+- Complex reasoning: gemini-2.5-pro
+- General use: gemini-2.5-flash
+- Fast responses: gemini-2.5-flash-lite
+- Cost-sensitive: gemini-2.0-flash-lite
+- Coding tasks: gemini-2.0-pro-experimental`;
+                break;
+            case 'parameters':
+                helpContent = this.getHelpContent('parameters');
+                break;
+            case 'examples':
+                helpContent = this.getHelpContent('examples');
+                break;
+            case 'quick-start':
+                helpContent = `# Quick Start Guide
+
+## 1. Basic Usage
+Just ask naturally:
+- "Use Gemini to [your request]"
+- "Ask Gemini about [topic]"
+
+## 2. Common Tasks
+
+**Text Generation:**
+"Use Gemini to write a function that sorts arrays"
+
+**Image Analysis:**
+"What's in this image?" [attach image]
+
+**Model Info:**
+"List all Gemini models"
+
+**Token Counting:**
+"Count tokens for my prompt"
+
+## 3. Advanced Features
+
+**JSON Output:**
+"Use Gemini in JSON mode to extract key points"
+
+**Current Information:**
+"Use Gemini with grounding to get latest news"
+
+**Conversations:**
+"Start a chat with Gemini about Python"
+
+## 4. Tips
+- Use gemini-2.5-flash for most tasks
+- Lower temperature for facts, higher for creativity
+- Enable grounding for current information
+- Use conversation IDs to maintain context
+
+## Need More Help?
+- "Get help on tools" - Detailed tool information
+- "Get help on parameters" - All parameters explained
+- "Get help on models" - Model selection guide`;
+                break;
+            default:
+                helpContent = 'Unknown help topic. Available topics: overview, tools, models, parameters, examples, quick-start';
+        }
+        return {
+            jsonrpc: '2.0',
+            id,
+            result: {
+                content: [{
+                        type: 'text',
+                        text: helpContent
+                    }]
+            }
+        };
+    }
+    sendResponse(response) {
+        const responseStr = JSON.stringify(response);
+        process.stdout.write(responseStr + '\n');
+    }
+}
+// Start the server
+const apiKey = process.env.GEMINI_API_KEY;
+if (!apiKey) {
+    console.error('GEMINI_API_KEY environment variable is required');
+    process.exit(1);
+}
+new EnhancedStdioMCPServer(apiKey);
+//# sourceMappingURL=enhanced-stdio-server.js.map