cat-gemini-mcp 1.2.0

package/LICENSE

@@ -0,0 +1,25 @@
+MIT License (Non-Commercial)
+
+Copyright (c) 2025 jamubc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software for non-commercial purposes only, including without limitation 
+the rights to use, copy, modify, merge, publish, and distribute copies of the 
+Software, and to permit persons to whom the Software is furnished to do so, 
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+Commercial use of this software is prohibited without prior written permission 
+from the copyright holder. For commercial licensing, please contact the 
+copyright holder directly.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,192 @@
+
+# Gemini MCP Tool
+
+<div align="center">
+
+[![GitHub Release](https://img.shields.io/github/v/release/jamubc/gemini-mcp-tool?logo=github&label=GitHub)](https://github.com/jamubc/gemini-mcp-tool/releases)
+[![npm version](https://img.shields.io/npm/v/gemini-mcp-tool)](https://www.npmjs.com/package/gemini-mcp-tool)
+[![npm downloads](https://img.shields.io/npm/dt/gemini-mcp-tool)](https://www.npmjs.com/package/gemini-mcp-tool)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Open Source](https://img.shields.io/badge/Open%20Source-❤️-red.svg)](https://github.com/jamubc/gemini-mcp-tool)
+
+</div>
+
+> 📚 **[View Full Documentation](https://jamubc.github.io/gemini-mcp-tool/)** - Search me!, Examples, FAQ, Troubleshooting, Best Practices
+
+This is a simple Model Context Protocol (MCP) server that allows AI assistants to interact with the [Gemini CLI](https://github.com/google-gemini/gemini-cli). It enables the AI to leverage the power of Gemini's massive token window for large analysis, especially with large files and codebases using the `@` syntax for direction.
+
+- Ask gemini natural questions, through claude or Brainstorm new ideas in a party of 3!
+
+<a href="https://glama.ai/mcp/servers/@jamubc/gemini-mcp-tool">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@jamubc/gemini-mcp-tool/badge" alt="Gemini Tool MCP server" />
+</a>
+
+## TLDR: [![Claude](https://img.shields.io/badge/Claude-D97757?logo=claude&logoColor=fff)](#) + [![Google Gemini](https://img.shields.io/badge/Google%20Gemini-886FBF?logo=googlegemini&logoColor=fff)](#)
+
+
+**Goal**: Use Gemini's powerful analysis capabilities directly in Claude Code to save tokens and analyze large files.
+
+## Prerequisites
+
+Before using this tool, ensure you have:
+
+1. **[Node.js](https://nodejs.org/)** (v16.0.0 or higher)
+2. **[Google Gemini CLI](https://github.com/google-gemini/gemini-cli)** installed and configured
+
+
+### One-Line Setup
+
+```bash
+claude mcp add gemini-cli -- npx -y gemini-mcp-tool
+```
+
+### Verify Installation
+
+Type `/mcp` inside Claude Code to verify the gemini-cli MCP is active.
+
+---
+
+### Alternative: Import from Claude Desktop
+
+If you already have it configured in Claude Desktop:
+
+1. Add to your Claude Desktop config:
+```json
+"gemini-cli": {
+  "command": "npx",
+  "args": ["-y", "gemini-mcp-tool"]
+}
+```
+
+2. Import to Claude Code:
+```bash
+claude mcp add-from-claude-desktop
+```
+
+## Configuration
+
+Register the MCP server with your MCP client:
+
+### For NPX Usage (Recommended)
+
+Add this configuration to your Claude Desktop config file:
+
+```json
+{
+  "mcpServers": {
+    "gemini-cli": {
+      "command": "npx",
+      "args": ["-y", "gemini-mcp-tool"]
+    }
+  }
+}
+```
+
+### With Custom Default Model
+
+You can set a default model via environment variable to avoid specifying it in every request:
+
+```json
+{
+  "mcpServers": {
+    "gemini-cli": {
+      "command": "npx",
+      "args": ["-y", "gemini-mcp-tool"],
+      "env": {
+        "GEMINI_DEFAULT_MODEL": "gemini-3-flash"
+      }
+    }
+  }
+}
+```
+
+Supported environment variables:
+- `GEMINI_DEFAULT_MODEL` - Sets the default Gemini model (e.g., `gemini-3-pro`, `gemini-3-flash`)
+- `DEFAULT_MODEL` - Alternative name for the same setting
+
+### For Global Installation
+
+If you installed globally, use this configuration instead:
+
+```json
+{
+  "mcpServers": {
+    "gemini-cli": {
+      "command": "gemini-mcp"
+    }
+  }
+}
+```
+
+**Configuration File Locations:**
+
+- **Claude Desktop**:
+  - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+  - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+  - **Linux**: `~/.config/claude/claude_desktop_config.json`
+
+After updating the configuration, restart your terminal session.
+
+## Example Workflow
+
+- **Natural language**: "use gemini to explain index.html", "understand the massive project using gemini", "ask gemini to search for latest news"
+- **Claude Code**: Type `/gemini-cli` and commands will populate in Claude Code's interface.
+
+## Usage Examples
+
+### With File References (using @ syntax)
+
+- `ask gemini to analyze @src/main.js and explain what it does`
+- `use gemini to summarize @. the current directory`
+- `analyze @package.json and tell me about dependencies`
+
+### General Questions (without files)
+
+- `ask gemini to search for the latest tech news`
+- `use gemini to explain div centering`
+- `ask gemini about best practices for React development related to @file_im_confused_about`
+
+### Using Gemini CLI's Sandbox Mode (-s)
+
+The sandbox mode allows you to safely test code changes, run scripts, or execute potentially risky operations in an isolated environment.
+
+- `use gemini sandbox to create and run a Python script that processes data`
+- `ask gemini to safely test @script.py and explain what it does`
+- `use gemini sandbox to install numpy and create a data visualization`
+- `test this code safely: Create a script that makes HTTP requests to an API`
+
+### Tools (for the AI)
+
+These tools are designed to be used by the AI assistant.
+
+- **`ask-gemini`**: Asks Google Gemini for its perspective. Can be used for general questions or complex analysis of files.
+  - **`prompt`** (required): The analysis request. Use the `@` syntax to include file or directory references (e.g., `@src/main.js explain this code`) or ask general questions (e.g., `Please use a web search to find the latest news stories`).
+  - **`model`** (optional): The Gemini model to use. Defaults to `gemini-3-pro`. You can specify alternative models like `gemini-3-flash` for faster responses.
+  - **`sandbox`** (optional): Set to `true` to run in sandbox mode for safe code execution.
+- **`sandbox-test`**: Safely executes code or commands in Gemini's sandbox environment. Always runs in sandbox mode.
+  - **`prompt`** (required): Code testing request (e.g., `Create and run a Python script that...` or `@script.py Run this safely`).
+  - **`model`** (optional): The Gemini model to use.
+- **`Ping`**: A simple test tool that echoes back a message.
+- **`Help`**: Shows the Gemini CLI help text.
+
+### Slash Commands (for the User)
+
+You can use these commands directly in Claude Code's interface (compatibility with other clients has not been tested).
+
+- **/analyze**: Analyzes files or directories using Gemini, or asks general questions.
+  - **`prompt`** (required): The analysis prompt. Use `@` syntax to include files (e.g., `/analyze prompt:@src/ summarize this directory`) or ask general questions (e.g., `/analyze prompt:Please use a web search to find the latest news stories`).
+- **/sandbox**: Safely tests code or scripts in Gemini's sandbox environment.
+  - **`prompt`** (required): Code testing request (e.g., `/sandbox prompt:Create and run a Python script that processes CSV data` or `/sandbox prompt:@script.py Test this script safely`).
+- **/help**: Displays the Gemini CLI help information.
+- **/ping**: Tests the connection to the server.
+  - **`message`** (optional): A message to echo back.
+
+## Contributing
+
+Contributions are welcome! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details on how to submit pull requests, report issues, and contribute to the project.
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+**Disclaimer:** This is an unofficial, third-party tool and is not affiliated with, endorsed, or sponsored by Google.

package/dist/constants.d.ts

@@ -0,0 +1,74 @@
+export declare const LOG_PREFIX = "[GMCPT]";
+export declare const ERROR_MESSAGES: {
+    readonly QUOTA_EXCEEDED: "Quota exceeded for quota metric 'Gemini 3 Pro Requests'";
+    readonly QUOTA_EXCEEDED_SHORT: "⚠️ Gemini 3 Pro daily quota exceeded. Please retry with model: 'gemini-3-flash'";
+    readonly TOOL_NOT_FOUND: "not found in registry";
+    readonly NO_PROMPT_PROVIDED: "Please provide a prompt for analysis. Use @ syntax to include files (e.g., '@largefile.js explain what this does') or ask general questions";
+};
+export declare const STATUS_MESSAGES: {
+    readonly QUOTA_SWITCHING: "🚫 Gemini 3 Pro quota exceeded, switching to Flash model...";
+    readonly FLASH_RETRY: "⚡ Retrying with Gemini 3 Flash...";
+    readonly FLASH_SUCCESS: "✅ Flash model completed successfully";
+    readonly SANDBOX_EXECUTING: "🔒 Executing Gemini CLI command in sandbox mode...";
+    readonly GEMINI_RESPONSE: "Gemini response:";
+    readonly PROCESSING_START: "🔍 Starting analysis (may take 5-15 minutes for large codebases)";
+    readonly PROCESSING_CONTINUE: "⏳ Still processing... Gemini is working on your request";
+    readonly PROCESSING_COMPLETE: "✅ Analysis completed successfully";
+};
+export declare const MODELS: {
+    readonly PRO: "gemini-3-pro";
+    readonly FLASH: "gemini-3-flash";
+};
+export declare const PROTOCOL: {
+    readonly ROLES: {
+        readonly USER: "user";
+        readonly ASSISTANT: "assistant";
+    };
+    readonly CONTENT_TYPES: {
+        readonly TEXT: "text";
+    };
+    readonly STATUS: {
+        readonly SUCCESS: "success";
+        readonly ERROR: "error";
+        readonly FAILED: "failed";
+        readonly REPORT: "report";
+    };
+    readonly NOTIFICATIONS: {
+        readonly PROGRESS: "notifications/progress";
+    };
+    readonly KEEPALIVE_INTERVAL: 25000;
+};
+export declare const CLI: {
+    readonly COMMANDS: {
+        readonly GEMINI: "gemini";
+        readonly ECHO: "echo";
+    };
+    readonly FLAGS: {
+        readonly MODEL: "-m";
+        readonly SANDBOX: "-s";
+        readonly PROMPT: "-p";
+        readonly HELP: "-help";
+    };
+    readonly DEFAULTS: {
+        readonly MODEL: "default";
+        readonly BOOLEAN_TRUE: "true";
+        readonly BOOLEAN_FALSE: "false";
+    };
+};
+export interface ToolArguments {
+    prompt?: string;
+    model?: string;
+    sandbox?: boolean | string;
+    changeMode?: boolean | string;
+    chunkIndex?: number | string;
+    chunkCacheKey?: string;
+    message?: string;
+    methodology?: string;
+    domain?: string;
+    constraints?: string;
+    existingContext?: string;
+    ideaCount?: number;
+    includeAnalysis?: boolean;
+    [key: string]: string | boolean | number | undefined;
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,YAAY,CAAC;AAGpC,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAGX,eAAO,MAAM,eAAe;;;;;;;;;CAUlB,CAAC;AAGX,eAAO,MAAM,MAAM;;;CAGT,CAAC;AAGX,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;CAuBX,CAAC;AAIX,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;CAmBN,CAAC;AAIX,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;CACtD"}

package/dist/constants.js

@@ -0,0 +1,73 @@
+// Logging
+export const LOG_PREFIX = "[GMCPT]";
+// Error messages
+export const ERROR_MESSAGES = {
+    QUOTA_EXCEEDED: "Quota exceeded for quota metric 'Gemini 3 Pro Requests'",
+    QUOTA_EXCEEDED_SHORT: "⚠️ Gemini 3 Pro daily quota exceeded. Please retry with model: 'gemini-3-flash'",
+    TOOL_NOT_FOUND: "not found in registry",
+    NO_PROMPT_PROVIDED: "Please provide a prompt for analysis. Use @ syntax to include files (e.g., '@largefile.js explain what this does') or ask general questions",
+};
+// Status messages
+export const STATUS_MESSAGES = {
+    QUOTA_SWITCHING: "🚫 Gemini 3 Pro quota exceeded, switching to Flash model...",
+    FLASH_RETRY: "⚡ Retrying with Gemini 3 Flash...",
+    FLASH_SUCCESS: "✅ Flash model completed successfully",
+    SANDBOX_EXECUTING: "🔒 Executing Gemini CLI command in sandbox mode...",
+    GEMINI_RESPONSE: "Gemini response:",
+    // Timeout prevention messages
+    PROCESSING_START: "🔍 Starting analysis (may take 5-15 minutes for large codebases)",
+    PROCESSING_CONTINUE: "⏳ Still processing... Gemini is working on your request",
+    PROCESSING_COMPLETE: "✅ Analysis completed successfully",
+};
+// Models
+export const MODELS = {
+    PRO: "gemini-3-pro",
+    FLASH: "gemini-3-flash",
+};
+// MCP Protocol Constants
+export const PROTOCOL = {
+    // Message roles
+    ROLES: {
+        USER: "user",
+        ASSISTANT: "assistant",
+    },
+    // Content types
+    CONTENT_TYPES: {
+        TEXT: "text",
+    },
+    // Status codes
+    STATUS: {
+        SUCCESS: "success",
+        ERROR: "error",
+        FAILED: "failed",
+        REPORT: "report",
+    },
+    // Notification methods
+    NOTIFICATIONS: {
+        PROGRESS: "notifications/progress",
+    },
+    // Timeout prevention
+    KEEPALIVE_INTERVAL: 25000, // 25 seconds
+};
+// CLI Constants
+export const CLI = {
+    // Command names
+    COMMANDS: {
+        GEMINI: "gemini",
+        ECHO: "echo",
+    },
+    // Command flags
+    FLAGS: {
+        MODEL: "-m",
+        SANDBOX: "-s",
+        PROMPT: "-p",
+        HELP: "-help",
+    },
+    // Default values
+    DEFAULTS: {
+        MODEL: "default", // Fallback model used when no specific model is provided
+        BOOLEAN_TRUE: "true",
+        BOOLEAN_FALSE: "false",
+    },
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,UAAU;AACV,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AAEpC,iBAAiB;AACjB,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,cAAc,EAAE,yDAAyD;IACzE,oBAAoB,EAAE,iFAAiF;IACvG,cAAc,EAAE,uBAAuB;IACvC,kBAAkB,EAAE,6IAA6I;CACzJ,CAAC;AAEX,kBAAkB;AAClB,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,eAAe,EAAE,6DAA6D;IAC9E,WAAW,EAAE,mCAAmC;IAChD,aAAa,EAAE,sCAAsC;IACrD,iBAAiB,EAAE,oDAAoD;IACvE,eAAe,EAAE,kBAAkB;IACnC,8BAA8B;IAC9B,gBAAgB,EAAE,kEAAkE;IACpF,mBAAmB,EAAE,yDAAyD;IAC9E,mBAAmB,EAAE,mCAAmC;CAChD,CAAC;AAEX,SAAS;AACT,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,GAAG,EAAE,cAAc;IACnB,KAAK,EAAE,gBAAgB;CACf,CAAC;AAEX,yBAAyB;AACzB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,gBAAgB;IAChB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM;QACZ,SAAS,EAAE,WAAW;KACvB;IACD,gBAAgB;IAChB,aAAa,EAAE;QACb,IAAI,EAAE,MAAM;KACb;IACD,eAAe;IACf,MAAM,EAAE;QACN,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,QAAQ;KACjB;IACD,uBAAuB;IACvB,aAAa,EAAE;QACb,QAAQ,EAAE,wBAAwB;KACnC;IACD,qBAAqB;IACrB,kBAAkB,EAAE,KAAK,EAAE,aAAa;CAChC,CAAC;AAGX,gBAAgB;AAChB,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,gBAAgB;IAChB,QAAQ,EAAE;QACR,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,MAAM;KACb;IACD,gBAAgB;IAChB,KAAK,EAAE;QACL,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,OAAO;KACd;IACD,iBAAiB;IACjB,QAAQ,EAAE;QACR,KAAK,EAAE,SAAS,EAAE,yDAAyD;QAC3E,YAAY,EAAE,MAAM;QACpB,aAAa,EAAE,OAAO;KACvB;CACO,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,188 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { Logger } from "./utils/logger.js";
+import { PROTOCOL } from "./constants.js";
+import { getToolDefinitions, getPromptDefinitions, executeTool, toolExists, getPromptMessage } from "./tools/index.js";
+const server = new Server({
+    name: "gemini-cli-mcp",
+    version: "1.1.4",
+}, {
+    capabilities: {
+        tools: {},
+        prompts: {},
+        notifications: {},
+        logging: {},
+    },
+});
+let isProcessing = false;
+let currentOperationName = "";
+let latestOutput = "";
+async function sendNotification(method, params) {
+    try {
+        await server.notification({ method, params });
+    }
+    catch (error) {
+        Logger.error("notification failed: ", error);
+    }
+}
+/**
+ * @param progressToken The progress token provided by the client
+ * @param progress The current progress value
+ * @param total Optional total value
+ * @param message Optional status message
+ */
+async function sendProgressNotification(progressToken, progress, total, message) {
+    if (!progressToken)
+        return; // Only send if client requested progress
+    try {
+        const params = {
+            progressToken,
+            progress
+        };
+        if (total !== undefined)
+            params.total = total; // future cache progress
+        if (message)
+            params.message = message;
+        await server.notification({
+            method: PROTOCOL.NOTIFICATIONS.PROGRESS,
+            params
+        });
+    }
+    catch (error) {
+        Logger.error("Failed to send progress notification:", error);
+    }
+}
+function startProgressUpdates(operationName, progressToken) {
+    isProcessing = true;
+    currentOperationName = operationName;
+    latestOutput = ""; // Reset latest output
+    const progressMessages = [
+        `🧠 ${operationName} - Gemini is analyzing your request...`,
+        `📊 ${operationName} - Processing files and generating insights...`,
+        `✨ ${operationName} - Creating structured response for your review...`,
+        `⏱️ ${operationName} - Large analysis in progress (this is normal for big requests)...`,
+        `🔍 ${operationName} - Still working... Gemini takes time for quality results...`,
+    ];
+    let messageIndex = 0;
+    let progress = 0;
+    // Send immediate acknowledgment if progress requested
+    if (progressToken) {
+        sendProgressNotification(progressToken, 0, undefined, // No total - indeterminate progress
+        `🔍 Starting ${operationName}`);
+    }
+    // Keep client alive with periodic updates
+    const progressInterval = setInterval(async () => {
+        if (isProcessing && progressToken) {
+            // Simply increment progress value
+            progress += 1;
+            // Include latest output if available
+            const baseMessage = progressMessages[messageIndex % progressMessages.length];
+            const outputPreview = latestOutput.slice(-150).trim(); // Last 150 chars
+            const message = outputPreview
+                ? `${baseMessage}\n📝 Output: ...${outputPreview}`
+                : baseMessage;
+            await sendProgressNotification(progressToken, progress, undefined, // No total - indeterminate progress
+            message);
+            messageIndex++;
+        }
+        else if (!isProcessing) {
+            clearInterval(progressInterval);
+        }
+    }, PROTOCOL.KEEPALIVE_INTERVAL); // Every 25 seconds
+    return { interval: progressInterval, progressToken };
+}
+function stopProgressUpdates(progressData, success = true) {
+    const operationName = currentOperationName; // Store before clearing
+    isProcessing = false;
+    currentOperationName = "";
+    clearInterval(progressData.interval);
+    // Send final progress notification if client requested progress
+    if (progressData.progressToken) {
+        sendProgressNotification(progressData.progressToken, 100, 100, success ? `✅ ${operationName} completed successfully` : `❌ ${operationName} failed`);
+    }
+}
+// tools/list
+server.setRequestHandler(ListToolsRequestSchema, async (request) => {
+    return { tools: getToolDefinitions() };
+});
+// tools/get
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const toolName = request.params.name;
+    if (toolExists(toolName)) {
+        // Check if client requested progress updates
+        const progressToken = request.params._meta?.progressToken;
+        // Start progress updates if client requested them
+        const progressData = startProgressUpdates(toolName, progressToken);
+        try {
+            // Get prompt and other parameters from arguments with proper typing
+            const args = request.params.arguments || {};
+            Logger.toolInvocation(toolName, request.params.arguments);
+            // Execute the tool using the unified registry with progress callback
+            const result = await executeTool(toolName, args, (newOutput) => {
+                latestOutput = newOutput;
+            });
+            // Stop progress updates
+            stopProgressUpdates(progressData, true);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: result,
+                    },
+                ],
+                isError: false,
+            };
+        }
+        catch (error) {
+            // Stop progress updates on error
+            stopProgressUpdates(progressData, false);
+            Logger.error(`Error in tool '${toolName}':`, error);
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error executing ${toolName}: ${errorMessage}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    else {
+        throw new Error(`Unknown tool: ${request.params.name}`);
+    }
+});
+// prompts/list
+server.setRequestHandler(ListPromptsRequestSchema, async (request) => {
+    return { prompts: getPromptDefinitions() };
+});
+// prompts/get
+server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+    const promptName = request.params.name;
+    const args = request.params.arguments || {};
+    const promptMessage = getPromptMessage(promptName, args);
+    if (!promptMessage) {
+        throw new Error(`Unknown prompt: ${promptName}`);
+    }
+    return {
+        messages: [{
+                role: "user",
+                content: {
+                    type: "text",
+                    text: promptMessage
+                }
+            }]
+    };
+});
+// Start the server
+async function main() {
+    Logger.debug("init gemini-mcp-tool");
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    Logger.debug("gemini-mcp-tool listening on stdio");
+}
+main().catch((error) => { Logger.error("Fatal error:", error); process.exit(1); });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,GASvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAiB,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,UAAU,EACV,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,OAAO;CACjB,EAAC;IACA,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,EAAE;QACX,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,EAAE;KACZ;CACF,CACF,CAAC;AAEF,IAAI,YAAY,GAAG,KAAK,CAAC;AAAC,IAAI,oBAAoB,GAAG,EAAE,CAAC;AAAC,IAAI,YAAY,GAAG,EAAE,CAAC;AAE/E,KAAK,UAAU,gBAAgB,CAAC,MAAc,EAAE,MAAW;IACzD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,wBAAwB,CACrC,aAA0C,EAC1C,QAAgB,EAChB,KAAc,EACd,OAAgB;IAEhB,IAAI,CAAC,aAAa;QAAE,OAAO,CAAC,yCAAyC;IAErE,IAAI,CAAC;QACH,MAAM,MAAM,GAAQ;YAClB,aAAa;YACb,QAAQ;SACT,CAAC;QAEF,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,wBAAwB;QACvE,IAAI,OAAO;YAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;QAEtC,MAAM,MAAM,CAAC,YAAY,CAAC;YACxB,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,QAAQ;YACvC,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAC3B,aAAqB,EACrB,aAA+B;IAE/B,YAAY,GAAG,IAAI,CAAC;IACpB,oBAAoB,GAAG,aAAa,CAAC;IACrC,YAAY,GAAG,EAAE,CAAC,CAAC,sBAAsB;IAEzC,MAAM,gBAAgB,GAAG;QACvB,MAAM,aAAa,wCAAwC;QAC3D,MAAM,aAAa,gDAAgD;QACnE,KAAK,aAAa,oDAAoD;QACtE,MAAM,aAAa,oEAAoE;QACvF,MAAM,aAAa,8DAA8D;KAClF,CAAC;IAEF,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,sDAAsD;IACtD,IAAI,aAAa,EAAE,CAAC;QAClB,wBAAwB,CACtB,aAAa,EACb,CAAC,EACD,SAAS,EAAE,oCAAoC;QAC/C,eAAe,aAAa,EAAE,CAC/B,CAAC;IACJ,CAAC;IAED,0CAA0C;IAC1C,MAAM,gBAAgB,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAC9C,IAAI,YAAY,IAAI,aAAa,EAAE,CAAC;YAClC,kCAAkC;YAClC,QAAQ,IAAI,CAAC,CAAC;YAEd,qCAAqC;YACrC,MAAM,WAAW,GAAG,gBAAgB,CAAC,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAC7E,MAAM,aAAa,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,iBAAiB;YACxE,MAAM,OAAO,GAAG,aAAa;gBAC3B,CAAC,CAAC,GAAG,WAAW,mBAAmB,aAAa,EAAE;gBAClD,CAAC,CAAC,WAAW,CAAC;YAEhB,MAAM,wBAAwB,CAC5B,aAAa,EACb,QAAQ,EACR,SAAS,EAAE,oCAAoC;YAC/C,OAAO,CACR,CAAC;YACF,YAAY,EAAE,CAAC;QACjB,CAAC;aAAM,IAAI,CAAC,YAAY,EAAE,CAAC;YACzB,aAAa,CAAC,gBAAgB,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,mBAAmB;IAEpD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,CAAC;AACvD,CAAC;AAED,SAAS,mBAAmB,CAC1B,YAA2E,EAC3E,UAAmB,IAAI;IAEvB,MAAM,aAAa,GAAG,oBAAoB,CAAC,CAAC,wBAAwB;IACpE,YAAY,GAAG,KAAK,CAAC;IACrB,oBAAoB,GAAG,EAAE,CAAC;IAC1B,aAAa,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAErC,gEAAgE;IAChE,IAAI,YAAY,CAAC,aAAa,EAAE,CAAC;QAC/B,wBAAwB,CACtB,YAAY,CAAC,aAAa,EAC1B,GAAG,EACH,GAAG,EACH,OAAO,CAAC,CAAC,CAAC,KAAK,aAAa,yBAAyB,CAAC,CAAC,CAAC,KAAK,aAAa,SAAS,CACpF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,aAAa;AACb,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,OAAyB,EAA8B,EAAE;IAC/G,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAuB,EAAE,CAAC;AAC9D,CAAC,CAAC,CAAC;AAEH,YAAY;AACZ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAwB,EAA2B,EAAE;IAC1G,MAAM,QAAQ,GAAW,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;IAE7C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,6CAA6C;QAC7C,MAAM,aAAa,GAAI,OAAO,CAAC,MAAc,CAAC,KAAK,EAAE,aAAa,CAAC;QAEnE,kDAAkD;QAClD,MAAM,YAAY,GAAG,oBAAoB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAEnE,IAAI,CAAC;YACH,oEAAoE;YACpE,MAAM,IAAI,GAAmB,OAAO,CAAC,MAAM,CAAC,SAA2B,IAAI,EAAE,CAAC;YAE9E,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAE1D,qEAAqE;YACrE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,EAAE;gBAC7D,YAAY,GAAG,SAAS,CAAC;YAC3B,CAAC,CAAC,CAAC;YAEH,wBAAwB;YACxB,mBAAmB,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YAExC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,MAAM;qBACb;iBACF;gBACD,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,iCAAiC;YACjC,mBAAmB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YAEzC,MAAM,CAAC,KAAK,CAAC,kBAAkB,QAAQ,IAAI,EAAE,KAAK,CAAC,CAAC;YAEpD,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAEzD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,mBAAmB,QAAQ,KAAK,YAAY,EAAE;qBACrD;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,KAAK,CAAC,iBAAiB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,eAAe;AACf,MAAM,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,KAAK,EAAE,OAA2B,EAAkC,EAAE;IACvH,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAyB,EAAE,CAAC;AACpE,CAAC,CAAC,CAAC;AAEH,cAAc;AACd,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,OAAyB,EAA4B,EAAE;IAC7G,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;IAE5C,MAAM,aAAa,GAAG,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAEzD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,mBAAmB,UAAU,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,CAAC;gBACT,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,aAAa;iBACpB;aACF,CAAC;KACH,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,mBAAmB;AACnB,KAAK,UAAU,IAAI;IACjB,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAAC,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9E,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;AACrD,CAAC;AAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,GAAE,MAAM,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/tools/ask-gemini.tool.d.ts

@@ -0,0 +1,3 @@
+import { UnifiedTool } from './registry.js';
+export declare const askGeminiTool: UnifiedTool;
+//# sourceMappingURL=ask-gemini.tool.d.ts.map

package/dist/tools/ask-gemini.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-gemini.tool.d.ts","sourceRoot":"","sources":["../../src/tools/ask-gemini.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAgB5C,eAAO,MAAM,aAAa,EAAE,WAsC3B,CAAC"}

package/dist/tools/ask-gemini.tool.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { executeGeminiCLI, processChangeModeOutput } from '../utils/geminiExecutor.js';
+import { ERROR_MESSAGES, STATUS_MESSAGES } from '../constants.js';
+const askGeminiArgsSchema = z.object({
+    prompt: z.string().min(1).describe("Analysis request. Use @ syntax to include files (e.g., '@largefile.js explain what this does') or ask general questions"),
+    model: z.string().optional().describe("Optional model to use (e.g., 'gemini-3-flash'). If not specified, uses the default model (gemini-3-pro)."),
+    sandbox: z.boolean().default(false).describe("Use sandbox mode (-s flag) to safely test code changes, execute scripts, or run potentially risky operations in an isolated environment"),
+    changeMode: z.boolean().default(false).describe("Enable structured change mode - formats prompts to prevent tool errors and returns structured edit suggestions that Claude can apply directly"),
+    chunkIndex: z.union([z.number(), z.string()]).optional().describe("Which chunk to return (1-based)"),
+    chunkCacheKey: z.string().optional().describe("Optional cache key for continuation"),
+});
+export const askGeminiTool = {
+    name: "ask-gemini",
+    description: "model selection [-m], sandbox [-s], and changeMode:boolean for providing edits",
+    zodSchema: askGeminiArgsSchema,
+    prompt: {
+        description: "Execute 'gemini <prompt>' to get Gemini AI's response. Supports enhanced change mode for structured edit suggestions.",
+    },
+    category: 'gemini',
+    execute: async (args, onProgress) => {
+        const { prompt, model, sandbox, changeMode, chunkIndex, chunkCacheKey } = args;
+        if (!prompt?.trim()) {
+            throw new Error(ERROR_MESSAGES.NO_PROMPT_PROVIDED);
+        }
+        if (changeMode && chunkIndex && chunkCacheKey) {
+            return processChangeModeOutput('', // empty for cache...
+            chunkIndex, chunkCacheKey, prompt);
+        }
+        const result = await executeGeminiCLI(prompt, model, !!sandbox, !!changeMode, onProgress);
+        if (changeMode) {
+            return processChangeModeOutput(result, args.chunkIndex, undefined, prompt);
+        }
+        return `${STATUS_MESSAGES.GEMINI_RESPONSE}\n${result}`; // changeMode false
+    }
+};
+//# sourceMappingURL=ask-gemini.tool.js.map

package/dist/tools/ask-gemini.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask-gemini.tool.js","sourceRoot":"","sources":["../../src/tools/ask-gemini.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACvF,OAAO,EACL,cAAc,EACd,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yHAAyH,CAAC;IAC7J,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0GAA0G,CAAC;IACjJ,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,yIAAyI,CAAC;IACvL,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,+IAA+I,CAAC;IAChM,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACpG,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CACrF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAgB;IACxC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,gFAAgF;IAC7F,SAAS,EAAE,mBAAmB;IAC9B,MAAM,EAAE;QACN,WAAW,EAAE,uHAAuH;KACrI;IACD,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;QAClC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YAAC,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;QAAC,CAAC;QAE5J,IAAI,UAAU,IAAI,UAAU,IAAI,aAAa,EAAE,CAAC;YAC9C,OAAO,uBAAuB,CAC5B,EAAE,EAAE,qBAAqB;YACzB,UAAoB,EACpB,aAAuB,EACvB,MAAgB,CACjB,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,gBAAgB,CACnC,MAAgB,EAChB,KAA2B,EAC3B,CAAC,CAAC,OAAO,EACT,CAAC,CAAC,UAAU,EACZ,UAAU,CACX,CAAC;QAEF,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,uBAAuB,CAC5B,MAAM,EACN,IAAI,CAAC,UAAgC,EACrC,SAAS,EACT,MAAgB,CACjB,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,eAAe,CAAC,eAAe,KAAK,MAAM,EAAE,CAAC,CAAC,mBAAmB;IAC7E,CAAC;CACF,CAAC"}

package/dist/tools/brainstorm.tool.d.ts

@@ -0,0 +1,3 @@
+import { UnifiedTool } from './registry.js';
+export declare const brainstormTool: UnifiedTool;
+//# sourceMappingURL=brainstorm.tool.d.ts.map

package/dist/tools/brainstorm.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brainstorm.tool.d.ts","sourceRoot":"","sources":["../../src/tools/brainstorm.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AA+H5C,eAAO,MAAM,cAAc,EAAE,WA0C5B,CAAC"}