gemini-web-mcp 0.1.2 → 0.2.0

package/README.md

@@ -191,11 +191,11 @@ Then use `gemini-web-mcp` as the command instead of `npx -y gemini-web-mcp` in y
 | Variable | Required | Default | Description |
 |----------|:--------:|---------|-------------|
 | `GEMINI_API_KEY` | ✓ | — | Your [Gemini API key](https://aistudio.google.com/apikey) |
-| `GEMINI_WEBSEARCH_MODEL` | | `gemini-3-flash-preview` | Model for web search |
-| `GEMINI_DEEP_RESEARCH_AGENT` | | `deep-research-pro-preview-12-2025` | Deep Research model |
-| `GEMINI_DEEP_RESEARCH_TIMEOUT` | | `1200` | Research timeout in seconds |
+| `GEMINI_WEBSEARCH_MODEL` | | `gemini-3.5-flash` | Model for web search |
+| `GEMINI_DEEP_RESEARCH_AGENT` | | `deep-research-preview-04-2026` | Deep Research model |
+| `GEMINI_DEEP_RESEARCH_TIMEOUT` | | `900` | Research timeout in seconds |
 | `GEMINI_DEEP_RESEARCH_POLL_INTERVAL` | | `10` | Polling interval in seconds |
-| `GEMINI_IMAGE_MODEL` | | `gemini-3-pro-image-preview` | Image generation model |
+| `GEMINI_IMAGE_MODEL` | | `gemini-3.1-flash-image` | Image generation model |
 | `LOG_LEVEL` | | `info` | Logging level |
 
 ---
@@ -206,9 +206,11 @@ Then use `gemini-web-mcp` as the command instead of `npx -y gemini-web-mcp` in y
 
 Performs a web search and returns an AI-synthesized summary with citations.
 
-| Parameter | Type | Required | Description |
-|-----------|------|:--------:|-------------|
-| `query` | string | ✓ | Search query |
+| Parameter | Type | Required | Default | Description |
+|-----------|------|:--------:|---------|-------------|
+| `query` | string | ✓ | — | Search query |
+| `domain` | string | | — | Optional domain to recommend the search prioritize |
+| `model` | string | | Configured default | Override default search model |
 
 ---
 
@@ -241,6 +243,7 @@ Conducts comprehensive web research using Gemini's Deep Research Agent. Blocks u
 |-----------|------|:--------:|---------|-------------|
 | `prompt` | string | ✓ | — | Research question or topic |
 | `include_citations` | boolean | | `true` | Include source URLs |
+| `agent` | string | | Configured default | Override default Deep Research Agent name |
 
 **Returns:** `{ status, report_text }`
 
@@ -255,6 +258,7 @@ Generate images from text prompts or edit existing images.
 | `prompt` | string | ✓ | — | Text description or edit instructions |
 | `images` | string[] | | — | File paths for image editing (up to 7) |
 | `aspect_ratio` | string | | `"1:1"` | `"1:1"`, `"16:9"`, `"9:16"`, `"4:3"`, `"3:4"` |
+| `model` | string | | Configured default | Override default image generation model |
 
 ---
 

package/dist/config.js

@@ -1,11 +1,11 @@
 import { z } from "zod";
 const configSchema = z.object({
     GEMINI_API_KEY: z.string().min(1).optional(),
-    GEMINI_WEBSEARCH_MODEL: z.string().min(1).default("gemini-3-flash-preview"),
-    GEMINI_DEEP_RESEARCH_AGENT: z.string().min(1).default("deep-research-pro-preview-12-2025"),
-    GEMINI_DEEP_RESEARCH_TIMEOUT: z.coerce.number().int().min(60).default(1200),
+    GEMINI_WEBSEARCH_MODEL: z.string().min(1).default("gemini-3.5-flash"),
+    GEMINI_DEEP_RESEARCH_AGENT: z.string().min(1).default("deep-research-preview-04-2026"),
+    GEMINI_DEEP_RESEARCH_TIMEOUT: z.coerce.number().int().min(60).default(900),
     GEMINI_DEEP_RESEARCH_POLL_INTERVAL: z.coerce.number().int().min(5).default(10),
-    GEMINI_IMAGE_MODEL: z.string().min(1).default("gemini-3-pro-image-preview"),
+    GEMINI_IMAGE_MODEL: z.string().min(1).default("gemini-3.1-flash-image"),
     LOG_LEVEL: z.enum(["debug", "info", "warn", "error"]).default("info")
 });
 export function loadConfig() {

package/dist/gemini/response.js

@@ -41,10 +41,24 @@ export function formatSources(chunks) {
     const sources = [];
     chunks.forEach((c, i) => {
         const title = c.web?.title?.trim();
-        if (!title || seen.has(title))
+        const uri = c.web?.uri?.trim();
+        // We need at least a title or a URI
+        if (!title && !uri)
             return;
-        seen.add(title);
-        sources.push(`[${i + 1}] ${title}`);
+        // Use URI for deduplication if available, otherwise title
+        const uniqueKey = uri || title;
+        if (!uniqueKey || seen.has(uniqueKey))
+            return;
+        seen.add(uniqueKey);
+        if (title && uri) {
+            sources.push(`[${i + 1}] ${title} (${uri})`);
+        }
+        else if (uri) {
+            sources.push(`[${i + 1}] ${uri}`);
+        }
+        else if (title) {
+            sources.push(`[${i + 1}] ${title}`);
+        }
     });
     return sources;
 }

package/dist/index.js

@@ -25,7 +25,7 @@ registerToolCompat(server, "search_web", {
         const ai = createGeminiClient(apiKey);
         const text = await runWebSearch({
             ai,
-            model: config.webSearchModel,
+            model: input.model || config.webSearchModel,
             input
         });
         return { content: [{ type: "text", text }] };
@@ -69,22 +69,22 @@ registerToolCompat(server, "view_content_chunk", {
         return { content: [{ type: "text", text: formatError(err) }], isError: true };
     }
 });
-const DEEP_RESEARCH_DESCRIPTION = `Conduct comprehensive web research using Gemini's Deep Research Agent.
-
-When to use this tool:
-- Researching complex topics requiring multi-source analysis
-- Need synthesized information from the web
-- Require fact-checking and cross-referencing of information
-
-Parameters:
-- \`prompt\`: Your research question or topic (required)
-- \`include_citations\`: Whether to include source URLs in the report (default: true)
-
-Returns:
-- \`status\`: Final state (completed, failed, cancelled)
-- \`report_text\`: The synthesized research report with findings
-
-Notes:
+const DEEP_RESEARCH_DESCRIPTION = `Conduct comprehensive web research using Gemini's Deep Research Agent.
+
+When to use this tool:
+- Researching complex topics requiring multi-source analysis
+- Need synthesized information from the web
+- Require fact-checking and cross-referencing of information
+
+Parameters:
+- \`prompt\`: Your research question or topic (required)
+- \`include_citations\`: Whether to include source URLs in the report (default: true)
+
+Returns:
+- \`status\`: Final state (completed, failed, cancelled)
+- \`report_text\`: The synthesized research report with findings
+
+Notes:
 - This tool blocks until research completes (typically 10-20 minutes)`;
 registerToolCompat(server, "gemini_deep_research", {
     title: "Gemini Deep Research",
@@ -96,7 +96,7 @@ registerToolCompat(server, "gemini_deep_research", {
         const ai = createGeminiClient(apiKey);
         const result = await runDeepResearch({
             ai,
-            agent: config.deepResearchAgent,
+            agent: input.agent || config.deepResearchAgent,
             timeoutSeconds: config.deepResearchTimeoutSeconds,
             pollIntervalSeconds: config.deepResearchPollIntervalSeconds,
             input
@@ -109,20 +109,20 @@ registerToolCompat(server, "gemini_deep_research", {
         return { content: [{ type: "text", text: formatError(err) }], isError: true };
     }
 });
-const CREATE_IMAGE_DESCRIPTION = `Generate or edit images using natural language instructions.
-
-Capabilities:
-- **Text-to-Image**: Generate images from text prompts
-- **Image-to-Image**: Edit existing images based on text instructions + reference image(s)
-
-Parameters:
-- \`prompt\`: Text prompt describing what to generate or how to edit (required)
-- \`images\`: Array of file paths to images for editing mode (optional, up to 7 images)
-- \`aspect_ratio\`: Output dimensions - "1:1", "16:9", "9:16", "4:3", "3:4" (optional, default: "1:1")
-
-Notes:
-- The resulting image will be saved as an artifact for use and file paths are returned
-- Image model can't generate transparent images, use workarounds
+const CREATE_IMAGE_DESCRIPTION = `Generate or edit images using natural language instructions.
+
+Capabilities:
+- **Text-to-Image**: Generate images from text prompts
+- **Image-to-Image**: Edit existing images based on text instructions + reference image(s)
+
+Parameters:
+- \`prompt\`: Text prompt describing what to generate or how to edit (required)
+- \`images\`: Array of file paths to images for editing mode (optional, up to 7 images)
+- \`aspect_ratio\`: Output dimensions - "1:1", "16:9", "9:16", "4:3", "3:4" (optional, default: "1:1")
+
+Notes:
+- The resulting image will be saved as an artifact for use and file paths are returned
+- Image model can't generate transparent images, use workarounds
 - For best results, be specific and descriptive in your prompts`;
 registerToolCompat(server, "create_image", {
     title: "Create Image",
@@ -134,7 +134,7 @@ registerToolCompat(server, "create_image", {
         const ai = createGeminiClient(apiKey);
         const result = await runCreateImage({
             ai,
-            model: config.imageModel,
+            model: input.model || config.imageModel,
             input
         });
         if (!result.success) {

package/dist/tools/deepResearch.js

@@ -14,7 +14,11 @@ export const deepResearchInput = z.object({
     include_citations: z
         .boolean()
         .default(true)
-        .describe("Whether to include source URLs in the report")
+        .describe("Whether to include source URLs in the report"),
+    agent: z
+        .string()
+        .optional()
+        .describe("Override the default Deep Research Agent name/model")
 });
 // --- URL Redirect Resolution ---
 /**

package/dist/tools/imageGeneration.js

@@ -10,7 +10,8 @@ const IMAGE_OUTPUT_DIR = path.join(os.tmpdir(), "gemini-mcp-images");
 export const createImageInput = {
     prompt: z.string().describe("Text prompt describing the image to generate or how to edit the input image(s)"),
     images: z.array(z.string()).optional().describe("Optional array of file paths to images for editing. Supports up to 7 images. Example: ['/path/to/image.png']"),
-    aspect_ratio: z.enum(["1:1", "16:9", "9:16", "4:3", "3:4"]).optional().describe("Output aspect ratio. Default: 1:1. Only used for generation, not editing.")
+    aspect_ratio: z.enum(["1:1", "16:9", "9:16", "4:3", "3:4"]).optional().describe("Output aspect ratio. Default: 1:1. Only used for generation, not editing."),
+    model: z.string().optional().describe("Override the default Gemini image model")
 };
 /**
  * Run image generation or editing using Gemini's native image model

package/dist/tools/webSearch.js

@@ -2,7 +2,8 @@ import { z } from "zod";
 import { safeGetResponseText, extractGrounding, addInlineCitations, formatSources } from "../gemini/response.js";
 export const webSearchInput = {
     query: z.string().describe("The search query to look up"),
-    domain: z.string().optional().describe("Optional domain to recommend the search prioritize")
+    domain: z.string().optional().describe("Optional domain to recommend the search prioritize"),
+    model: z.string().optional().describe("Override the default Gemini model used for search")
 };
 export async function runWebSearch(params) {
     const systemInstruction = buildSystemInstruction(params.input.domain);
@@ -30,19 +31,19 @@ export async function runWebSearch(params) {
     return lines.join("\n");
 }
 function buildSystemInstruction(domain) {
-    const base = `You are a web search assistant with real-time search capabilities.
-
-**Response Guidelines:**
-- For factual/quick lookups (dates, definitions, simple facts): Be brief and direct
-- For complex topics (how-to, comparisons, analysis): Provide structured, detailed explanations
-- For current events/news: Summarize key points with context and timeline
-- For technical queries: Include relevant code, specifications, or documentation references
-
-**Core Principles:**
-- Always use the most recent and authoritative sources
-- Lead with the direct answer, then expand if needed
-- Use bullet points or numbered lists for multi-part information
-- Omit filler phrases and redundant context
+    const base = `You are a web search assistant with real-time search capabilities.
+
+**Response Guidelines:**
+- For factual/quick lookups (dates, definitions, simple facts): Be brief and direct
+- For complex topics (how-to, comparisons, analysis): Provide structured, detailed explanations
+- For current events/news: Summarize key points with context and timeline
+- For technical queries: Include relevant code, specifications, or documentation references
+
+**Core Principles:**
+- Always use the most recent and authoritative sources
+- Lead with the direct answer, then expand if needed
+- Use bullet points or numbered lists for multi-part information
+- Omit filler phrases and redundant context
 - Match the depth of your response to the complexity of the query`;
     if (domain) {
         return `${base}\nPrioritize results from: ${domain}`;

package/package.json

@@ -1,56 +1,56 @@
-{
-  "name": "gemini-web-mcp",
-  "version": "0.1.2",
-  "description": "MCP server with Gemini-powered web tools: search, content extraction, deep research, and image generation",
-  "author": "bharatvansh",
-  "license": "MIT",
-  "type": "module",
-  "keywords": [
-    "mcp",
-    "gemini",
-    "google",
-    "ai",
-    "web-search",
-    "deep-research",
-    "image-generation",
-    "model-context-protocol"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/bharatvansh/gemini-web-mcp.git"
-  },
-  "homepage": "https://github.com/bharatvansh/gemini-web-mcp#readme",
-  "bugs": {
-    "url": "https://github.com/bharatvansh/gemini-web-mcp/issues"
-  },
-  "bin": {
-    "gemini-web-mcp": "dist/index.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "dev": "tsx watch src/index.ts",
-    "build": "tsc -p tsconfig.json",
-    "start": "node dist/index.js",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
-  },
-  "dependencies": {
-    "@google/genai": "^1.0.0",
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "@mozilla/readability": "^0.6.0",
-    "dotenv": "^16.4.5",
-    "jsdom": "^28.0.0",
-    "node-html-markdown": "^2.0.0",
-    "zod": "^3.24.2"
-  },
-  "devDependencies": {
-    "@types/jsdom": "^27.0.0",
-    "@types/node": "^20.11.30",
-    "tsx": "^4.19.2",
-    "typescript": "^5.7.3"
-  },
-  "engines": {
-    "node": ">=18"
-  }
+{
+  "name": "gemini-web-mcp",
+  "version": "0.2.0",
+  "description": "MCP server with Gemini-powered web tools: search, content extraction, deep research, and image generation",
+  "author": "bharatvansh",
+  "license": "MIT",
+  "type": "module",
+  "keywords": [
+    "mcp",
+    "gemini",
+    "google",
+    "ai",
+    "web-search",
+    "deep-research",
+    "image-generation",
+    "model-context-protocol"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bharatvansh/gemini-web-mcp.git"
+  },
+  "homepage": "https://github.com/bharatvansh/gemini-web-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/bharatvansh/gemini-web-mcp/issues"
+  },
+  "bin": {
+    "gemini-web-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@google/genai": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@mozilla/readability": "^0.6.0",
+    "dotenv": "^16.4.5",
+    "jsdom": "^28.0.0",
+    "node-html-markdown": "^2.0.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/jsdom": "^27.0.0",
+    "@types/node": "^20.11.30",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=18"
+  }
 }

package/dist/tools/pageSummary.js

@@ -1,43 +0,0 @@
-import { z } from "zod";
-import { safeGetResponseText } from "../gemini/response.js";
-export const pageSummaryInput = {
-    url: z.string().url(),
-    focus: z.string().min(1).optional(),
-    summary_length: z.enum(["short", "medium", "long"]).default("medium"),
-    max_output_tokens: z.number().int().min(128).max(4096).default(1024)
-};
-export async function runPageSummary(params) {
-    const prompt = buildPrompt(params.input.url, params.input.focus, params.input.summary_length);
-    const response = await params.ai.models.generateContent({
-        model: params.model,
-        contents: [{ role: "user", parts: [{ text: prompt }] }],
-        config: {
-            tools: [{ urlContext: {} }],
-            temperature: 1.0,
-            maxOutputTokens: params.input.max_output_tokens
-        }
-    });
-    const summary = safeGetResponseText(response).trim();
-    const lines = [];
-    lines.push(`## URL\n\n${params.input.url}`);
-    lines.push(`\n## Summary\n\n${summary || "_No summary returned._"}`);
-    return lines.join("\n");
-}
-function buildPrompt(url, focus, length) {
-    const lengthGuidance = length === "short"
-        ? "Write 5–8 bullet points and a 2-sentence summary."
-        : length === "long"
-            ? "Write a detailed outline with sections and key takeaways."
-            : "Write a medium-length summary with sections and bullet points.";
-    const focusLine = focus ? `Focus on: ${focus}` : "Cover the most important information on the page.";
-    return [
-        "Summarize the content of the URL using URL context retrieval.",
-        "Do not rely on prior knowledge. If the page cannot be accessed or parsed, say so explicitly.",
-        "",
-        `URL: ${url}`,
-        focusLine,
-        "",
-        lengthGuidance,
-        "Output markdown."
-    ].join("\n");
-}

package/dist/utils/resolveUrl.js

@@ -1,71 +0,0 @@
-/**
- * Resolve Gemini grounding redirect URLs to actual source URLs.
- */
-const REDIRECT_URL_PATTERN = /https:\/\/vertexaisearch\.cloud\.google\.com\/grounding-api-redirect\/[A-Za-z0-9_-]+/g;
-const RESOLVE_TIMEOUT = 10000; // 10 seconds
-// Simple cache for resolved URLs
-const urlCache = new Map();
-/**
- * Follow a redirect URL and return the final destination.
- */
-export async function resolveRedirectUrl(url) {
-    if (!url || !url.includes('grounding-api-redirect')) {
-        return null;
-    }
-    // Check cache first
-    if (urlCache.has(url)) {
-        return urlCache.get(url);
-    }
-    try {
-        const controller = new AbortController();
-        const timeoutId = setTimeout(() => controller.abort(), RESOLVE_TIMEOUT);
-        // Use HEAD request with redirect: 'manual' to capture Location header
-        const response = await fetch(url, {
-            method: 'HEAD',
-            redirect: 'manual',
-            signal: controller.signal
-        });
-        clearTimeout(timeoutId);
-        // Check for redirect status codes
-        if ([301, 302, 303, 307, 308].includes(response.status)) {
-            const location = response.headers.get('location');
-            if (location) {
-                urlCache.set(url, location);
-                return location;
-            }
-        }
-        // Fallback: try GET with follow redirects
-        const getResponse = await fetch(url, {
-            method: 'GET',
-            redirect: 'follow',
-            signal: controller.signal
-        });
-        const finalUrl = getResponse.url;
-        if (finalUrl !== url && !finalUrl.includes('grounding-api-redirect')) {
-            urlCache.set(url, finalUrl);
-            return finalUrl;
-        }
-    }
-    catch (error) {
-        // Silently fail - return null
-    }
-    return null;
-}
-/**
- * Resolve a single source object's URL if it's a redirect URL.
- */
-export async function resolveSource(source) {
-    if (source.url.includes('grounding-api-redirect')) {
-        const resolved = await resolveRedirectUrl(source.url);
-        if (resolved) {
-            return { ...source, url: resolved };
-        }
-    }
-    return source;
-}
-/**
- * Resolve all sources in an array concurrently.
- */
-export async function resolveSources(sources) {
-    return Promise.all(sources.map(resolveSource));
-}