@joeytheman/gemini-mcp-tool 1.3.0

package/LICENSE

@@ -0,0 +1,26 @@
+MIT License (Non-Commercial)
+
+Copyright (c) 2025 jamubc (original author)
+Copyright (c) 2026 joeytheman (fork maintainer)
+
+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,239 @@
+
+# Gemini MCP Tool
+
+<div align="center">
+
+[![GitHub Release](https://img.shields.io/github/v/release/joeytheman/gemini-mcp-tool?logo=github&label=GitHub)](https://github.com/joeytheman/gemini-mcp-tool/releases)
+[![npm version](https://img.shields.io/npm/v/@joeytheman/gemini-mcp-tool)](https://www.npmjs.com/package/@joeytheman/gemini-mcp-tool)
+[![npm downloads](https://img.shields.io/npm/dt/@joeytheman/gemini-mcp-tool)](https://www.npmjs.com/package/@joeytheman/gemini-mcp-tool)
+[![License: MIT Non-Commercial](https://img.shields.io/badge/License-MIT%20Non--Commercial-blue.svg)](./LICENSE)
+[![Open Source](https://img.shields.io/badge/Open%20Source-❤️-red.svg)](https://github.com/joeytheman/gemini-mcp-tool)
+
+</div>
+
+> 📚 **[View Full Documentation](https://joeytheman.github.io/gemini-mcp-tool/)** - Search me!, Examples, FAQ, Troubleshooting, Best Practices
+
+> **Fork Notice:** This project is a fork of [jamubc/gemini-mcp-tool](https://github.com/jamubc/gemini-mcp-tool), originally created by [jamubc](https://github.com/jamubc). We are grateful to the original author for their foundational work.
+
+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/@joeytheman/gemini-mcp-tool">
+  <img width="380" height="200" src="https://glama.ai/mcp/servers/@joeytheman/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/)** (v18.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 @joeytheman/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", "@joeytheman/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", "@joeytheman/gemini-mcp-tool"]
+    }
+  }
+}
+```
+
+### For Global Installation
+
+If you installed globally, use this configuration instead:
+
+```json
+{
+  "mcpServers": {
+    "gemini-cli": {
+      "command": "gemini-mcp"
+    }
+  }
+}
+```
+
+### Optional: Enable Response Caching
+
+To enable the LRU response cache for near-instant repeated queries, add the `GEMINI_CACHE_ENABLED` environment variable:
+
+```json
+{
+  "mcpServers": {
+    "gemini-cli": {
+      "command": "npx",
+      "args": ["-y", "@joeytheman/gemini-mcp-tool"],
+      "env": {
+        "GEMINI_CACHE_ENABLED": "true"
+      }
+    }
+  }
+}
+```
+
+Caching is disabled by default. When enabled, responses are cached with a 30-minute TTL and 10MB max size.
+
+**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`**: Execute Gemini CLI with full feature support including advanced flags, caching, and change mode.
+  - **`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-preview`. Use `gemini-3-flash-preview` for faster responses.
+  - **`sandbox`** (optional): Set to `true` to run in sandbox mode for safe code execution.
+  - **`changeMode`** (optional): Enable structured change mode for edit suggestions that Claude can apply directly.
+  - **`yolo`** (optional): Auto-accept all actions (YOLO mode). Use with caution.
+  - **`approvalMode`** (optional): Fine-grained approval control: `default`, `auto_edit`, or `yolo`.
+  - **`outputFormat`** (optional): Control output format: `text`, `json`, or `stream-json`.
+  - **`includeDirectories`** (optional): Additional directories to include in workspace.
+  - **`debug`** (optional): Enable verbose logging for troubleshooting.
+  - **`promptInteractive`** (optional): Execute prompt and continue in interactive mode.
+  - **`extensions`** (optional): Filter specific file extensions.
+  - **`resume`** (optional): Resume previous session (use `latest` or session number).
+  - **`workingDirectory`** (optional): Working directory to run Gemini from. Use drive root (e.g., 'C:/' or 'D:/') on Windows to access files across drives.
+
+- **`brainstorm`**: Generate creative ideas with structured methodologies and domain context.
+  - **`prompt`** (required): Brainstorming challenge or question to explore.
+  - **`model`** (optional): The Gemini model to use.
+  - **`methodology`** (optional): Framework to use: `divergent`, `convergent`, `scamper`, `design-thinking`, `lateral`, or `auto` (default).
+  - **`domain`** (optional): Domain context (e.g., 'software', 'business', 'creative', 'research').
+  - **`constraints`** (optional): Known limitations or requirements.
+  - **`ideaCount`** (optional): Number of ideas to generate (default: 12).
+  - **`includeAnalysis`** (optional): Include feasibility and impact analysis (default: true).
+
+- **`fetch-chunk`**: Retrieve cached chunks from large changeMode responses.
+  - **`cacheKey`** (required): Cache key from initial changeMode response.
+  - **`chunkIndex`** (required): Chunk number to retrieve (1-based index).
+
+- **`ping`**: Echo test message to verify server connection.
+  - **`prompt`** (optional): Message to echo back.
+
+- **`Help`**: Display Gemini CLI help information.
+
+### Slash Commands (for the User)
+
+You can use these commands directly in Claude Code's interface (compatibility with other clients has not been tested).
+
+- **/ask-gemini**: Execute Gemini CLI with advanced features and caching.
+  - **Example**: `/ask-gemini prompt:@src/ summarize this directory`
+  - **With sandbox**: `/ask-gemini prompt:@script.py test this safely sandbox:true`
+  - **With change mode**: `/ask-gemini prompt:Refactor this code changeMode:true`
+  - **Supports all flags**: yolo, approvalMode, outputFormat, debug, etc.
+
+- **/brainstorm**: Generate structured ideas with creative methodologies.
+  - **Example**: `/brainstorm prompt:How can we improve user onboarding? methodology:design-thinking domain:software`
+  - **Quick use**: `/brainstorm prompt:Ideas for a mobile app feature`
+
+- **/fetch-chunk**: Retrieve next chunk of a large changeMode response.
+  - **Example**: `/fetch-chunk cacheKey:abc123 chunkIndex:2`
+
+- **/Help**: Display Gemini CLI help information.
+  - **Example**: `/Help`
+
+- **/ping**: Test the MCP server connection.
+  - **Example**: `/ping prompt:Hello server!`
+
+## Performance Features
+
+This MCP server includes several performance optimizations:
+
+- **LRU Response Cache** (opt-in): Near-instant responses for repeated queries with 30-minute TTL and 10MB max size. Enable via `GEMINI_CACHE_ENABLED=true` env var.
+- **Efficient Command Execution**: O(n) array buffer performance for large outputs
+- **Smart Chunking**: Large changeMode responses are automatically chunked for better handling
+- **Progress Notifications**: Real-time progress updates during long-running operations
+
+## 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.
+
+## Acknowledgments
+
+This project was originally created by [jamubc](https://github.com/jamubc) and is maintained as a fork by [joeytheman](https://github.com/joeytheman). The original repository can be found at [jamubc/gemini-mcp-tool](https://github.com/jamubc/gemini-mcp-tool).
+
+## License
+
+This project is licensed under the MIT License (Non-Commercial). Commercial use is prohibited without prior written permission from the original copyright holder. See the [LICENSE](LICENSE) file for full details.
+
+**Disclaimer:** This is an unofficial, third-party tool and is not affiliated with, endorsed, or sponsored by Google.

package/dist/__tests__/ask-gemini.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ask-gemini.test.d.ts.map

package/dist/__tests__/ask-gemini.test.d.ts.map

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

package/dist/__tests__/ask-gemini.test.js

@@ -0,0 +1,165 @@
+import { describe, it, expect } from 'vitest';
+import { z } from 'zod';
+describe('ask-gemini Tool', () => {
+    describe('Argument Schema Validation', () => {
+        const askGeminiArgsSchema = z.object({
+            prompt: z.string().min(1),
+            model: z.string().optional(),
+            sandbox: z.boolean().default(false),
+            changeMode: z.boolean().default(false),
+            chunkIndex: z.union([z.number(), z.string()]).optional(),
+            chunkCacheKey: z.string().optional(),
+            yolo: z.boolean().default(false),
+            approvalMode: z.enum(['default', 'auto_edit', 'yolo']).optional(),
+            outputFormat: z.enum(['text', 'json', 'stream-json']).optional(),
+            includeDirectories: z.union([z.string(), z.array(z.string())]).optional(),
+            debug: z.boolean().default(false),
+            promptInteractive: z.string().optional(),
+            extensions: z.union([z.string(), z.array(z.string())]).optional(),
+            resume: z.string().optional(),
+        });
+        it('should accept valid minimal arguments', () => {
+            const result = askGeminiArgsSchema.parse({ prompt: 'test prompt' });
+            expect(result.prompt).toBe('test prompt');
+            expect(result.sandbox).toBe(false);
+            expect(result.changeMode).toBe(false);
+        });
+        it('should accept all optional flags', () => {
+            const result = askGeminiArgsSchema.parse({
+                prompt: 'test prompt',
+                model: 'gemini-3-flash-preview',
+                sandbox: true,
+                changeMode: true,
+                yolo: true,
+                approvalMode: 'auto_edit',
+                outputFormat: 'json',
+                debug: true,
+            });
+            expect(result.model).toBe('gemini-3-flash-preview');
+            expect(result.sandbox).toBe(true);
+            expect(result.changeMode).toBe(true);
+            expect(result.yolo).toBe(true);
+            expect(result.approvalMode).toBe('auto_edit');
+            expect(result.outputFormat).toBe('json');
+            expect(result.debug).toBe(true);
+        });
+        it('should reject missing prompt', () => {
+            expect(() => askGeminiArgsSchema.parse({})).toThrow();
+        });
+        it('should reject empty prompt', () => {
+            expect(() => askGeminiArgsSchema.parse({ prompt: '' })).toThrow();
+        });
+        it('should reject invalid approval mode', () => {
+            expect(() => askGeminiArgsSchema.parse({
+                prompt: 'test',
+                approvalMode: 'invalid',
+            })).toThrow();
+        });
+        it('should reject invalid output format', () => {
+            expect(() => askGeminiArgsSchema.parse({
+                prompt: 'test',
+                outputFormat: 'invalid',
+            })).toThrow();
+        });
+        it('should accept includeDirectories as string', () => {
+            const result = askGeminiArgsSchema.parse({
+                prompt: 'test',
+                includeDirectories: 'src,tests',
+            });
+            expect(result.includeDirectories).toBe('src,tests');
+        });
+        it('should accept includeDirectories as array', () => {
+            const result = askGeminiArgsSchema.parse({
+                prompt: 'test',
+                includeDirectories: ['src', 'tests'],
+            });
+            expect(result.includeDirectories).toEqual(['src', 'tests']);
+        });
+        it('should accept extensions as string', () => {
+            const result = askGeminiArgsSchema.parse({
+                prompt: 'test',
+                extensions: 'ts,js',
+            });
+            expect(result.extensions).toBe('ts,js');
+        });
+        it('should accept extensions as array', () => {
+            const result = askGeminiArgsSchema.parse({
+                prompt: 'test',
+                extensions: ['ts', 'js'],
+            });
+            expect(result.extensions).toEqual(['ts', 'js']);
+        });
+        it('should accept resume parameter', () => {
+            const result = askGeminiArgsSchema.parse({
+                prompt: 'test',
+                resume: 'latest',
+            });
+            expect(result.resume).toBe('latest');
+        });
+        it('should accept chunkIndex as number', () => {
+            const result = askGeminiArgsSchema.parse({
+                prompt: 'test',
+                chunkIndex: 1,
+            });
+            expect(result.chunkIndex).toBe(1);
+        });
+        it('should accept chunkIndex as string', () => {
+            const result = askGeminiArgsSchema.parse({
+                prompt: 'test',
+                chunkIndex: '1',
+            });
+            expect(result.chunkIndex).toBe('1');
+        });
+    });
+    describe('Flag Combinations', () => {
+        const askGeminiArgsSchema = z.object({
+            prompt: z.string().min(1),
+            sandbox: z.boolean().default(false),
+            yolo: z.boolean().default(false),
+            approvalMode: z.enum(['default', 'auto_edit', 'yolo']).optional(),
+        });
+        it('should allow sandbox with yolo', () => {
+            const result = askGeminiArgsSchema.parse({
+                prompt: 'test',
+                sandbox: true,
+                yolo: true,
+            });
+            expect(result.sandbox).toBe(true);
+            expect(result.yolo).toBe(true);
+        });
+        it('should allow approvalMode to override yolo', () => {
+            const result = askGeminiArgsSchema.parse({
+                prompt: 'test',
+                yolo: true,
+                approvalMode: 'auto_edit',
+            });
+            expect(result.yolo).toBe(true);
+            expect(result.approvalMode).toBe('auto_edit');
+            // Note: In actual implementation, approvalMode should take precedence
+        });
+    });
+    describe('Error Messages', () => {
+        const askGeminiArgsSchema = z.object({
+            prompt: z.string().min(1),
+        });
+        it('should provide clear error for missing prompt', () => {
+            try {
+                askGeminiArgsSchema.parse({});
+            }
+            catch (error) {
+                expect(error.issues[0].path).toContain('prompt');
+                expect(error.issues[0].message).toMatch(/required/i);
+            }
+        });
+        it('should provide clear error for empty prompt', () => {
+            try {
+                askGeminiArgsSchema.parse({ prompt: '' });
+            }
+            catch (error) {
+                expect(error.issues[0].path).toContain('prompt');
+                expect(error.issues[0].message).toMatch(/at least 1/i);
+            }
+        });
+    });
+});
+//# sourceMappingURL=ask-gemini.test.js.map

package/dist/__tests__/ask-gemini.test.js.map

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

package/dist/__tests__/server.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.test.d.ts.map

package/dist/__tests__/server.test.d.ts.map

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

package/dist/__tests__/server.test.js

@@ -0,0 +1,72 @@
+import { describe, it, expect, vi, beforeAll } from 'vitest';
+// Track constructor calls manually using plain arrays.
+// vitest's mockReset clears mock.calls between tests, but these arrays persist.
+const serverConstructorCalls = [];
+const stdioTransportConstructorCalls = [];
+const setRequestHandlerCalls = [];
+const mockServerInstance = {
+    setRequestHandler: vi.fn((...args) => {
+        setRequestHandlerCalls.push(args);
+    }),
+    connect: vi.fn().mockResolvedValue(undefined),
+    notification: vi.fn(),
+};
+vi.mock('@modelcontextprotocol/sdk/server/index.js', () => ({
+    Server: vi.fn((...args) => {
+        serverConstructorCalls.push(args);
+        return mockServerInstance;
+    }),
+}));
+vi.mock('@modelcontextprotocol/sdk/server/stdio.js', () => ({
+    StdioServerTransport: vi.fn((...args) => {
+        stdioTransportConstructorCalls.push(args);
+        return {};
+    }),
+}));
+vi.mock('../utils/logger.js', () => ({
+    Logger: {
+        debug: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        log: vi.fn(),
+        toolInvocation: vi.fn(),
+        commandExecution: vi.fn(),
+        commandComplete: vi.fn(),
+    },
+}));
+describe('Gemini MCP Server', () => {
+    beforeAll(async () => {
+        await import('../index.js');
+    });
+    describe('Server Initialization', () => {
+        it('should create server with correct name and version', () => {
+            expect(serverConstructorCalls.length).toBeGreaterThanOrEqual(1);
+            const [serverConfig] = serverConstructorCalls[0];
+            expect(serverConfig).toHaveProperty('name', 'gemini-cli-mcp');
+            expect(serverConfig).toHaveProperty('version');
+        });
+        it('should register capabilities', () => {
+            const [, capabilities] = serverConstructorCalls[0];
+            expect(capabilities).toHaveProperty('capabilities');
+            expect(capabilities.capabilities).toHaveProperty('tools');
+            expect(capabilities.capabilities).toHaveProperty('prompts');
+        });
+    });
+    describe('Request Handlers', () => {
+        it('should register at least 4 request handlers', () => {
+            expect(setRequestHandlerCalls.length).toBeGreaterThanOrEqual(4);
+        });
+    });
+    describe('Progress Notifications', () => {
+        it('should support progress notifications', () => {
+            expect(mockServerInstance).toHaveProperty('notification');
+            expect(typeof mockServerInstance.notification).toBe('function');
+        });
+    });
+    describe('Transport Connection', () => {
+        it('should create StdioServerTransport', () => {
+            expect(stdioTransportConstructorCalls.length).toBeGreaterThanOrEqual(1);
+        });
+    });
+});
+//# sourceMappingURL=server.test.js.map

package/dist/__tests__/server.test.js.map

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

package/dist/__tests__/tools.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tools.test.d.ts.map

package/dist/__tests__/tools.test.d.ts.map

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