mcp-server-gemini 1.1.0

package/dist/tools/multimodal-query.js

@@ -0,0 +1,83 @@
+/**
+ * Tool 2: gemini_multimodal_query
+ * Query using images + text for multimodal understanding
+ * Priority: P0 - Core functionality
+ */
+import { validateRequired, validateString, validateArray, validateOutputFormat } from '../utils/validators.js';
+import { handleAPIError, logError } from '../utils/error-handler.js';
+// System prompt for multimodal query
+const MULTIMODAL_QUERY_SYSTEM_PROMPT = `You are a visual understanding expert with deep knowledge of:
+- UI/UX design patterns and principles
+- Frontend development (HTML/CSS/JavaScript)
+- Architecture diagrams and technical documentation
+- Design systems and component libraries
+
+When analyzing images:
+1. Identify all key elements and their purposes
+2. Understand spatial relationships and layouts
+3. Recognize design patterns and conventions
+4. Detect colors, typography, spacing with precision
+5. Infer interactive states (hover, active, disabled)
+
+When asked to convert designs to code:
+- Provide complete, production-ready implementation
+- Match the design pixel-perfectly
+- Include all visible and implied interactions
+
+When asked questions about designs:
+- Be specific and detailed
+- Reference exact colors (hex codes)
+- Mention spacing values when relevant
+- Suggest improvements if asked
+
+Output format:
+- Adapt to the requested format (text/code/json)
+- Be concise but comprehensive
+- Use professional terminology`;
+/**
+ * Handle gemini_multimodal_query tool call
+ */
+export async function handleMultimodalQuery(params, client) {
+    try {
+        // Validate required parameters
+        validateRequired(params.prompt, 'prompt');
+        validateString(params.prompt, 'prompt', 5);
+        validateRequired(params.images, 'images');
+        validateArray(params.images, 'images', 1);
+        // Validate optional parameters
+        const outputFormat = params.outputFormat || 'text';
+        if (params.outputFormat) {
+            validateOutputFormat(params.outputFormat);
+        }
+        // Build the prompt
+        let fullPrompt = params.prompt;
+        if (params.context) {
+            fullPrompt = `Context: ${params.context}\n\nQuestion: ${params.prompt}`;
+        }
+        if (outputFormat === 'json') {
+            fullPrompt += `\n\nPlease provide your response in valid JSON format.`;
+        }
+        else if (outputFormat === 'code') {
+            fullPrompt += `\n\nPlease provide your response as code only, no explanations.`;
+        }
+        // Call Gemini API with multimodal input
+        const response = await client.generateMultimodal(fullPrompt, params.images, {
+            systemInstruction: MULTIMODAL_QUERY_SYSTEM_PROMPT,
+            temperature: 0.7,
+            maxTokens: 4096
+        });
+        return {
+            response,
+            format: outputFormat,
+            metadata: {
+                imageCount: params.images.length,
+                modelUsed: client.getModel()
+            }
+        };
+    }
+    catch (error) {
+        logError('multimodalQuery', error);
+        throw handleAPIError(error);
+    }
+}
+//# sourceMappingURL=multimodal-query.js.map

package/dist/tools/multimodal-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multimodal-query.js","sourceRoot":"","sources":["../../src/tools/multimodal-query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErE,qCAAqC;AACrC,MAAM,8BAA8B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;+BA2BR,CAAC;AAkBhC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAA6B,EAC7B,MAAoB;IAEpB,IAAI,CAAC;QACH,+BAA+B;QAC/B,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC1C,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC3C,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC1C,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAE1C,+BAA+B;QAC/B,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC;QACnD,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,oBAAoB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC5C,CAAC;QAED,mBAAmB;QACnB,IAAI,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;QAE/B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,UAAU,GAAG,YAAY,MAAM,CAAC,OAAO,iBAAiB,MAAM,CAAC,MAAM,EAAE,CAAC;QAC1E,CAAC;QAED,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;YAC5B,UAAU,IAAI,wDAAwD,CAAC;QACzE,CAAC;aAAM,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;YACnC,UAAU,IAAI,iEAAiE,CAAC;QAClF,CAAC;QAED,wCAAwC;QACxC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAC9C,UAAU,EACV,MAAM,CAAC,MAAM,EACb;YACE,iBAAiB,EAAE,8BAA8B;YACjD,WAAW,EAAE,GAAG;YAChB,SAAS,EAAE,IAAI;SAChB,CACF,CAAC;QAEF,OAAO;YACL,QAAQ;YACR,MAAM,EAAE,YAAY;YACpB,QAAQ,EAAE;gBACR,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;gBAChC,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE;aAC7B;SACF,CAAC;IAEJ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,QAAQ,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;QACnC,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/tools/search.js

@@ -0,0 +1,94 @@
+/**
+ * Tool: gemini_search
+ * Web search using Gemini's built-in Google Search grounding
+ */
+import { GoogleGenAI } from '@google/genai';
+import { validateRequired, validateString } from '../utils/validators.js';
+import { handleAPIError, logError } from '../utils/error-handler.js';
+// Search system prompt
+const SEARCH_SYSTEM_PROMPT = `You are a helpful research assistant with access to Google Search.
+When answering questions:
+1. Use the search results to provide accurate, up-to-date information
+2. Cite sources when possible
+3. Be clear about what information comes from search results
+4. If search results are insufficient, acknowledge limitations
+5. Synthesize information from multiple sources when relevant`;
+/**
+ * Handle gemini_search tool invocation
+ */
+export async function handleSearch(params, apiKey) {
+    try {
+        // Parameter validation
+        validateRequired(params.query, 'query');
+        validateString(params.query, 'query', 2);
+        if (params.context) {
+            validateString(params.context, 'context', 2);
+        }
+        const thinkingLevel = params.thinkingLevel || 'high';
+        const outputFormat = params.outputFormat || 'text';
+        // Create AI client
+        const ai = new GoogleGenAI({ apiKey });
+        // Configure tools with Google Search
+        const tools = [{ googleSearch: {} }];
+        const config = {
+            tools,
+            thinkingConfig: { thinkingLevel },
+        };
+        // Add JSON output configuration if requested
+        if (outputFormat === 'json') {
+            config.responseMimeType = 'application/json';
+        }
+        // Build prompt
+        let prompt = params.query;
+        if (params.context) {
+            prompt = `Context: ${params.context}\n\nQuestion: ${params.query}`;
+        }
+        const model = 'gemini-3-pro-preview';
+        const contents = [
+            {
+                role: 'user',
+                parts: [{ text: prompt }],
+            },
+        ];
+        // Add system instruction to config
+        config.systemInstruction = SEARCH_SYSTEM_PROMPT;
+        // Call Gemini API with search grounding
+        const response = await ai.models.generateContent({
+            model,
+            config,
+            contents,
+        });
+        // Extract response text
+        const responseText = response.text || '';
+        // Extract grounding metadata if available
+        let groundingMetadata;
+        const candidate = response.candidates?.[0];
+        if (candidate?.groundingMetadata) {
+            const metadata = candidate.groundingMetadata;
+            groundingMetadata = {
+                searchQueries: metadata.webSearchQueries,
+                webSearchSources: metadata.groundingSupports?.map((support) => ({
+                    title: support.segment?.text,
+                    uri: support.groundingChunkIndices?.[0] !== undefined
+                        ? metadata.groundingChunks?.[support.groundingChunkIndices[0]]?.web?.uri
+                        : undefined,
+                })),
+            };
+        }
+        return {
+            query: params.query,
+            response: responseText,
+            groundingMetadata,
+            metadata: {
+                modelUsed: model,
+                thinkingLevel,
+                outputFormat,
+            },
+        };
+    }
+    catch (error) {
+        logError('search', error);
+        throw handleAPIError(error);
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EACL,gBAAgB,EAChB,cAAc,EACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErE,uBAAuB;AACvB,MAAM,oBAAoB,GAAG;;;;;;8DAMiC,CAAC;AA4B/D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAoB,EACpB,MAAc;IAEd,IAAI,CAAC;QACH,uBAAuB;QACvB,gBAAgB,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACxC,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAEzC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC;QACrD,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC;QAEnD,mBAAmB;QACnB,MAAM,EAAE,GAAG,IAAI,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAEvC,qCAAqC;QACrC,MAAM,KAAK,GAAG,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QAErC,MAAM,MAAM,GAAQ;YAClB,KAAK;YACL,cAAc,EAAE,EAAE,aAAa,EAAE;SAClC,CAAC;QAEF,6CAA6C;QAC7C,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;YAC5B,MAAM,CAAC,gBAAgB,GAAG,kBAAkB,CAAC;QAC/C,CAAC;QAED,eAAe;QACf,IAAI,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,GAAG,YAAY,MAAM,CAAC,OAAO,iBAAiB,MAAM,CAAC,KAAK,EAAE,CAAC;QACrE,CAAC;QAED,MAAM,KAAK,GAAG,sBAAsB,CAAC;QACrC,MAAM,QAAQ,GAAG;YACf;gBACE,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;aAC1B;SACF,CAAC;QAEF,mCAAmC;QACnC,MAAM,CAAC,iBAAiB,GAAG,oBAAoB,CAAC;QAEhD,wCAAwC;QACxC,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC;YAC/C,KAAK;YACL,MAAM;YACN,QAAQ;SACT,CAAC,CAAC;QAEH,wBAAwB;QACxB,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;QAEzC,0CAA0C;QAC1C,IAAI,iBAAoD,CAAC;QAEzD,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAI,SAAS,EAAE,iBAAiB,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,SAAS,CAAC,iBAAwB,CAAC;YACpD,iBAAiB,GAAG;gBAClB,aAAa,EAAE,QAAQ,CAAC,gBAAgB;gBACxC,gBAAgB,EAAE,QAAQ,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,OAAY,EAAE,EAAE,CAAC,CAAC;oBACnE,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI;oBAC5B,GAAG,EAAE,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS;wBACnD,CAAC,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG;wBACxE,CAAC,CAAC,SAAS;iBACd,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,YAAY;YACtB,iBAAiB;YACjB,QAAQ,EAAE;gBACR,SAAS,EAAE,KAAK;gBAChB,aAAa;gBACb,YAAY;aACb;SACF,CAAC;IAEJ,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC1B,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/error-handler.js

@@ -0,0 +1,69 @@
+/**
+ * Error handling utilities
+ */
+import { ERROR_CODES } from '../config/constants.js';
+/**
+ * Create MCP error object
+ */
+export function createMCPError(code, message, data) {
+    return { code, message, data };
+}
+/**
+ * Handle API errors
+ */
+export function handleAPIError(error) {
+    // API Key error
+    if (error.message?.includes('API key') || error.message?.includes('Invalid key')) {
+        return createMCPError(ERROR_CODES.API_ERROR, 'Invalid API key. Please check your GEMINI_API_KEY environment variable.', { originalError: error.message });
+    }
+    // Quota error
+    if (error.message?.includes('quota') || error.message?.includes('rate limit')) {
+        return createMCPError(ERROR_CODES.RATE_LIMIT, 'API quota exceeded or rate limit reached. Please try again later.', { originalError: error.message });
+    }
+    // Timeout error
+    if (error.message?.includes('timeout')) {
+        return createMCPError(ERROR_CODES.TIMEOUT, 'Request timeout. The operation took too long to complete.', { originalError: error.message });
+    }
+    // Model not supported
+    if (error.message?.includes('model') || error.message?.includes('not found')) {
+        return createMCPError(ERROR_CODES.MODEL_NOT_SUPPORTED, 'The specified model is not supported or not available.', { originalError: error.message });
+    }
+    // Generic API error
+    return createMCPError(ERROR_CODES.API_ERROR, error.message || 'An error occurred while calling the Gemini API.', { originalError: error.message });
+}
+/**
+ * Handle parameter validation errors
+ */
+export function handleValidationError(message, details) {
+    return createMCPError(ERROR_CODES.INVALID_PARAMS, message, details);
+}
+/**
+ * Handle internal errors
+ */
+export function handleInternalError(error) {
+    return createMCPError(ERROR_CODES.INTERNAL_ERROR, 'Internal server error', { originalError: error.message });
+}
+/**
+ * Sanitize error message (prevent sensitive information leakage)
+ */
+export function sanitizeErrorMessage(error) {
+    if (typeof error === 'string') {
+        return error.replace(/apiKey\s*=\s*[^\s]+/gi, 'apiKey=***');
+    }
+    if (error.message) {
+        return error.message.replace(/apiKey\s*=\s*[^\s]+/gi, 'apiKey=***');
+    }
+    return 'Unknown error';
+}
+/**
+ * Log error (for debugging)
+ */
+export function logError(context, error) {
+    const timestamp = new Date().toISOString();
+    const sanitized = sanitizeErrorMessage(error);
+    console.error(`[${timestamp}] [${context}] Error:`, sanitized);
+    if (error.stack) {
+        console.error('Stack trace:', error.stack);
+    }
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/utils/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"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"}