@tuannvm/gemini-mcp-server 1.0.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,381 @@
+# Gemini MCP Server
+
+[![npm version](https://img.shields.io/npm/v/@tuannvm/gemini-mcp-server.svg)](https://www.npmjs.com/package/@tuannvm/gemini-mcp-server)
+[![npm downloads](https://img.shields.io/npm/dm/@tuannvm/gemini-mcp-server.svg)](https://www.npmjs.com/package/@tuannvm/gemini-mcp-server)
+[![license](https://img.shields.io/npm/l/@tuannvm/gemini-mcp-server.svg)](https://www.npmjs.com/package/@tuannvm/gemini-mcp-server)
+
+MCP server for Google Gemini CLI integration with large file analysis, web search, multimodal analysis, shell commands, and brainstorming support.
+
+```mermaid
+graph LR
+    A[Claude Code] --> B[Gemini MCP Server]
+
+    B --> C[ask-gemini]
+    B --> S[search]
+    B --> M[analyze-media]
+    B --> SH[shell]
+    B --> D[brainstorm]
+    B --> E[fetch-chunk]
+    B --> F[ping]
+    B --> G[help]
+
+    C --> H[Gemini CLI]
+    S --> H
+    M --> H
+    SH --> H
+    D --> H
+    C --> I[Chunk Cache]
+    E --> I
+
+    style A fill:#FF6B35
+    style B fill:#4A90E2
+    style C fill:#00D4AA
+    style S fill:#00D4AA
+    style M fill:#00D4AA
+    style SH fill:#00D4AA
+    style D fill:#00D4AA
+    style E fill:#00D4AA
+    style F fill:#00D4AA
+    style G fill:#00D4AA
+    style H fill:#4285F4
+    style I fill:#9B59B6
+```
+
+## Prerequisites
+
+- **Google Gemini CLI v0.22.2+** must be pre-installed and configured
+  - Install: `npm install -g @google/gemini-cli`
+  - Authenticate: Run `gemini` and login with Google (free tier: 60 req/min, 1000 req/day)
+  - Or set API key: `export GEMINI_API_KEY="YOUR_API_KEY"`
+  - **Recommended**: Set default model to Gemini 3 Pro (see [Model Configuration](#model-configuration))
+- **Node.js v18+** installed
+- **Claude Code** or compatible MCP client
+
+## Installation
+
+### One-Click Installation
+
+#### VS Code
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Gemini_MCP_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=gemini-cli&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40tuannvm%2Fgemini-mcp-server%22%5D%7D)
+
+#### VS Code Insiders
+[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Gemini_MCP_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=gemini-cli&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40tuannvm%2Fgemini-mcp-server%22%5D%7D)
+
+#### Cursor
+[![Install in Cursor](https://img.shields.io/badge/Cursor-Install_Gemini_MCP_Server-00D8FF?style=flat-square&logo=cursor&logoColor=white)](https://cursor.com/en/install-mcp?name=gemini-cli&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IC15IEB0dWFubnZtL2dlbWluaS1tY3Atc2VydmVyIiwiZW52Ijp7fX0=)
+
+### Manual Installation
+
+#### Claude Code
+```bash
+claude mcp add gemini-cli -- npx -y @tuannvm/gemini-mcp-server
+```
+
+#### Claude Desktop
+Add to your Claude Desktop configuration file:
+
+**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+**Windows:** `%APPDATA%/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "gemini-cli": {
+      "command": "npx",
+      "args": ["-y", "@tuannvm/gemini-mcp-server"]
+    }
+  }
+}
+```
+
+## Usage in Claude Code
+
+Once installed, Claude Code can use these tools:
+
+### `ask-gemini` - File Analysis & Questions
+Analyze files and codebases using Gemini's large context window with the `@` syntax.
+
+**Basic Usage:**
+```
+Use ask-gemini to analyze @src/main.js and explain what it does
+```
+
+**Advanced Usage:**
+```
+# Model selection (defaults to gemini-3-pro-preview)
+Use ask-gemini with model "gemini-3-flash-preview" to quickly summarize @package.json
+
+# Sandbox mode for safe code execution
+Use ask-gemini with sandbox true to test @script.py safely
+
+# Change mode for structured edits
+Use ask-gemini with changeMode true to refactor @src/utils.ts
+```
+
+**Parameters:**
+- `prompt` (required): Your question or analysis request. Use `@` syntax for file references
+- `model` (optional): Model to use (`gemini-3-pro-preview` or `gemini-3-flash-preview`)
+- `sandbox` (optional): Enable sandbox mode for safe execution
+- `changeMode` (optional): Enable structured edit mode for code changes
+
+### `search` - Web Search with Google Grounding
+Search the web using Gemini with Google Search grounding for real-time information.
+
+**Basic Usage:**
+```
+Use search to find the latest React 19 features
+```
+
+**Advanced Usage:**
+```
+# Get raw results without summarization
+Use search with query "kubernetes security best practices 2025" and summarize false
+
+# Use specific model
+Use search with query "latest AI news" and model "gemini-3-pro-preview"
+```
+
+**Parameters:**
+- `query` (required): Search query
+- `summarize` (optional): Summarize results (default: true)
+- `model` (optional): Model to use (default: gemini-3-flash-preview for speed)
+
+### `analyze-media` - Multimodal Analysis
+Analyze images, PDFs, screenshots, and diagrams using Gemini's multimodal capabilities.
+
+**Basic Usage:**
+```
+Use analyze-media with filePath "@screenshot.png" and prompt "describe this UI"
+```
+
+**Advanced Usage:**
+```
+# Detailed analysis
+Use analyze-media with filePath "@architecture.pdf" and prompt "explain the system design" and detailed true
+
+# Quick analysis with Flash model
+Use analyze-media with filePath "@error.png" and prompt "what's the error?" and model "gemini-3-flash-preview"
+```
+
+**Parameters:**
+- `filePath` (required): Path to media file (use `@` syntax)
+- `prompt` (required): What to analyze or extract
+- `model` (optional): Model to use (default: gemini-3-pro-preview for multimodal)
+- `detailed` (optional): Provide detailed analysis
+
+### `shell` - Shell Command Generation
+Generate and optionally execute shell commands using Gemini.
+
+**Basic Usage:**
+```
+Use shell with task "find all TypeScript files larger than 100KB"
+```
+
+**Advanced Usage:**
+```
+# Dry run (default) - explains commands without executing
+Use shell with task "clean up node_modules and rebuild" and dryRun true
+
+# Execute in sandbox (safe)
+Use shell with task "run the test suite" and dryRun false
+
+# With working directory
+Use shell with task "list all TODO comments" and workingDirectory "@src/"
+```
+
+**Parameters:**
+- `task` (required): Description of the shell task
+- `dryRun` (optional): If true, explains commands without executing (default: true)
+- `workingDirectory` (optional): Working directory for execution
+- `model` (optional): Model to use (default: gemini-3-flash-preview)
+
+### `brainstorm` - Creative Ideation
+Generate ideas using various brainstorming methodologies.
+
+**Basic Usage:**
+```
+Use brainstorm to generate ideas for improving user onboarding
+```
+
+**Advanced Usage:**
+```
+# Specific methodology
+Use brainstorm with methodology "SCAMPER" to improve the checkout flow
+
+# Domain-specific brainstorming
+Use brainstorm with domain "mobile" and ideaCount 10 for app features
+
+# With analysis
+Use brainstorm with includeAnalysis true to evaluate idea feasibility
+```
+
+**Parameters:**
+- `prompt` (required): The brainstorming topic
+- `methodology` (optional): Framework to use (`divergent`, `convergent`, `SCAMPER`, `design-thinking`, `lateral`, `auto`)
+- `domain` (optional): Domain context for specialized ideas
+- `constraints` (optional): Known limitations or requirements
+- `ideaCount` (optional): Target number of ideas to generate
+- `includeAnalysis` (optional): Include feasibility and impact analysis
+
+### `fetch-chunk` - Retrieve Cached Chunks
+Retrieve cached chunks from large changeMode responses.
+
+**Parameters:**
+- `cacheKey` (required): Cache key from previous response
+- `chunkIndex` (required): Chunk index to retrieve (1-based)
+
+### `ping` - Connection Test
+Test if the MCP server is working properly.
+
+### `help` - Gemini CLI Help
+Get information about Gemini CLI capabilities and commands.
+
+## Example Workflows
+
+**Large Codebase Analysis:**
+```
+Use ask-gemini to analyze @. and provide an architecture overview
+```
+
+**File Comparison:**
+```
+Use ask-gemini to compare @src/old.ts and @src/new.ts and explain the differences
+```
+
+**Code Refactoring with Structured Edits:**
+```
+Use ask-gemini with changeMode true to refactor @src/utils.ts for better error handling
+```
+
+**Creative Brainstorming:**
+```
+Use brainstorm with methodology "design-thinking" to improve the user dashboard experience
+```
+
+**Web Research:**
+```
+Use search to find the latest security vulnerabilities in npm packages
+```
+
+**Screenshot Analysis:**
+```
+Use analyze-media with filePath "@error-screenshot.png" and prompt "explain this error and suggest a fix"
+```
+
+**Shell Task Automation:**
+```
+Use shell with task "find all files modified in the last 24 hours" and dryRun false
+```
+
+## Advanced Features
+
+### Large File Handling
+- Gemini's massive context window handles large files that would exceed other models' limits
+- Use `@` syntax to reference files: `@src/main.js`, `@.` (current directory)
+- Automatic chunking for very large responses with cache retrieval
+
+### Change Mode (Structured Edits)
+When `changeMode` is enabled, responses are formatted as structured edits that can be automatically applied:
+- Parses `**FILE: path:line**` format with `OLD/NEW` blocks
+- Chunks large edit responses for manageable processing
+- 10-minute cache TTL for chunk retrieval
+
+### Model Fallback
+- Automatically falls back from `gemini-3-pro-preview` to `gemini-3-flash-preview` when quota is exceeded
+- Transparent retry with status notification
+
+### Progress Notifications
+For long-running operations, the server sends `notifications/progress` messages when the client provides a `progressToken`.
+
+## Model Configuration
+
+### Setting the Default Model
+
+You can configure the default Gemini model using three methods (in order of precedence):
+
+**1. Environment Variable (Recommended)**
+```bash
+export GEMINI_MODEL="gemini-3-pro-preview"
+```
+
+**2. Settings File**
+
+Create `~/.gemini/settings.json` (user-level) or `.gemini/settings.json` (project-level):
+```json
+{
+  "model": {
+    "name": "gemini-3-pro-preview"
+  }
+}
+```
+
+**3. Command-Line Flag**
+```bash
+gemini -m gemini-3-pro-preview
+```
+
+### Available Models
+
+| Model | ID | Best For |
+|-------|-----|----------|
+| **Gemini 3 Pro** (default) | `gemini-3-pro-preview` | Most capable, complex reasoning |
+| **Gemini 3 Flash** | `gemini-3-flash-preview` | Fast responses, good quality |
+| Gemini 2.5 Flash-Lite | `gemini-2.5-flash-lite` | Fastest, lightweight |
+
+### Configuration Precedence
+
+Settings are applied in order (highest priority last):
+1. Default values
+2. User settings file (`~/.gemini/settings.json`)
+3. Project settings file (`.gemini/settings.json`)
+4. Environment variables (`GEMINI_MODEL`)
+5. Command-line arguments (`-m`)
+6. MCP tool `model` parameter (overrides all)
+
+### Recommended Setup
+
+For best results, set Gemini 3 Pro as your default:
+
+```bash
+# Add to your shell profile (~/.bashrc, ~/.zshrc, etc.)
+export GEMINI_MODEL="gemini-3-pro-preview"
+```
+
+Or create a user settings file:
+```bash
+mkdir -p ~/.gemini
+echo '{"model": {"name": "gemini-3-pro-preview"}}' > ~/.gemini/settings.json
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Development mode
+npm run dev
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Lint and format
+npm run lint
+npm run format
+```
+
+## Documentation
+
+- [API Reference](docs/api-reference.md)
+- [Gemini CLI Integration](docs/gemini-cli-integration.md)
+- [Full Documentation Site](https://tuannvm.github.io/gemini-mcp-server/)
+
+## License
+
+MIT
+
+**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,58 @@
+/**
+ * Constants for the Gemini MCP Server
+ */
+export { ToolArguments, MODELS } from './types.js';
+export declare const LOG_PREFIX = "[GMCP]";
+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-preview'";
+    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 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";
+    };
+};
+//# 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":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGnD,eAAO,MAAM,UAAU,WAAW,CAAC;AAGnC,eAAO,MAAM,cAAc;;;;;CAOjB,CAAC;AAGX,eAAO,MAAM,eAAe;;;;;;;;;CAUlB,CAAC;AAGX,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;CAkBX,CAAC;AAGX,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;CAgBN,CAAC"}

package/dist/constants.js

@@ -0,0 +1,64 @@
+/**
+ * Constants for the Gemini MCP Server
+ */
+// Re-export types for backward compatibility
+export { MODELS } from './types.js';
+// Logging
+export const LOG_PREFIX = '[GMCP]';
+// 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-preview'",
+    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:',
+    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',
+};
+// MCP Protocol Constants
+export const PROTOCOL = {
+    ROLES: {
+        USER: 'user',
+        ASSISTANT: 'assistant',
+    },
+    CONTENT_TYPES: {
+        TEXT: 'text',
+    },
+    STATUS: {
+        SUCCESS: 'success',
+        ERROR: 'error',
+        FAILED: 'failed',
+        REPORT: 'report',
+    },
+    NOTIFICATIONS: {
+        PROGRESS: 'notifications/progress',
+    },
+    KEEPALIVE_INTERVAL: 25000,
+};
+// CLI Constants
+export const CLI = {
+    COMMANDS: {
+        GEMINI: 'gemini',
+        ECHO: 'echo',
+    },
+    FLAGS: {
+        MODEL: '-m',
+        SANDBOX: '-s',
+        PROMPT: '-p',
+        HELP: '-help',
+    },
+    DEFAULTS: {
+        MODEL: 'default',
+        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":"AAAA;;GAEG;AAEH,6CAA6C;AAC7C,OAAO,EAAiB,MAAM,EAAE,MAAM,YAAY,CAAC;AAEnD,UAAU;AACV,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;AAEnC,iBAAiB;AACjB,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,cAAc,EAAE,yDAAyD;IACzE,oBAAoB,EAClB,sFAAsF;IACxF,cAAc,EAAE,uBAAuB;IACvC,kBAAkB,EAChB,6IAA6I;CACvI,CAAC;AAEX,kBAAkB;AAClB,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,eAAe,EAAE,0DAA0D;IAC3E,WAAW,EAAE,iCAAiC;IAC9C,aAAa,EAAE,oCAAoC;IACnD,iBAAiB,EAAE,iDAAiD;IACpE,eAAe,EAAE,kBAAkB;IACnC,gBAAgB,EACd,+DAA+D;IACjE,mBAAmB,EAAE,uDAAuD;IAC5E,mBAAmB,EAAE,iCAAiC;CAC9C,CAAC;AAEX,yBAAyB;AACzB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM;QACZ,SAAS,EAAE,WAAW;KACvB;IACD,aAAa,EAAE;QACb,IAAI,EAAE,MAAM;KACb;IACD,MAAM,EAAE;QACN,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,QAAQ;KACjB;IACD,aAAa,EAAE;QACb,QAAQ,EAAE,wBAAwB;KACnC;IACD,kBAAkB,EAAE,KAAK;CACjB,CAAC;AAEX,gBAAgB;AAChB,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,QAAQ,EAAE;QACR,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,MAAM;KACb;IACD,KAAK,EAAE;QACL,KAAK,EAAE,IAAI;QACX,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,OAAO;KACd;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,SAAS;QAChB,YAAY,EAAE,MAAM;QACpB,aAAa,EAAE,OAAO;KACvB;CACO,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Custom error classes for the Gemini MCP Server
+ */
+export declare class ToolExecutionError extends Error {
+    readonly toolName: string;
+    readonly cause?: Error | undefined;
+    constructor(toolName: string, message: string, cause?: Error | undefined);
+}
+export declare class CommandExecutionError extends Error {
+    readonly command: string;
+    readonly exitCode?: number | undefined;
+    constructor(command: string, message: string, exitCode?: number | undefined);
+}
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}
+export declare class QuotaExceededError extends Error {
+    constructor(model: string);
+}
+/**
+ * Handle errors and return a user-friendly message
+ */
+export declare function handleError(error: unknown, context: string): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,kBAAmB,SAAQ,KAAK;aAEzB,QAAQ,EAAE,MAAM;aAEhB,KAAK,CAAC,EAAE,KAAK;gBAFb,QAAQ,EAAE,MAAM,EAChC,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED,qBAAa,qBAAsB,SAAQ,KAAK;aAE5B,OAAO,EAAE,MAAM;aAEf,QAAQ,CAAC,EAAE,MAAM;gBAFjB,OAAO,EAAE,MAAM,EAC/B,OAAO,EAAE,MAAM,EACC,QAAQ,CAAC,EAAE,MAAM,YAAA;CAKpC;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,KAAK,EAAE,MAAM;CAI1B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAsBnE"}

package/dist/errors.js

@@ -0,0 +1,57 @@
+/**
+ * Custom error classes for the Gemini MCP Server
+ */
+export class ToolExecutionError extends Error {
+    toolName;
+    cause;
+    constructor(toolName, message, cause) {
+        super(`Error executing tool '${toolName}': ${message}`);
+        this.toolName = toolName;
+        this.cause = cause;
+        this.name = 'ToolExecutionError';
+    }
+}
+export class CommandExecutionError extends Error {
+    command;
+    exitCode;
+    constructor(command, message, exitCode) {
+        super(`Command '${command}' failed: ${message}`);
+        this.command = command;
+        this.exitCode = exitCode;
+        this.name = 'CommandExecutionError';
+    }
+}
+export class ValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ValidationError';
+    }
+}
+export class QuotaExceededError extends Error {
+    constructor(model) {
+        super(`Quota exceeded for model: ${model}`);
+        this.name = 'QuotaExceededError';
+    }
+}
+/**
+ * Handle errors and return a user-friendly message
+ */
+export function handleError(error, context) {
+    if (error instanceof ToolExecutionError) {
+        return `${context}: ${error.message}`;
+    }
+    if (error instanceof CommandExecutionError) {
+        return `${context}: ${error.message}`;
+    }
+    if (error instanceof ValidationError) {
+        return `Validation error in ${context}: ${error.message}`;
+    }
+    if (error instanceof QuotaExceededError) {
+        return `${context}: ${error.message}`;
+    }
+    if (error instanceof Error) {
+        return `${context}: ${error.message}`;
+    }
+    return `${context}: An unknown error occurred`;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAEzB;IAEA;IAHlB,YACkB,QAAgB,EAChC,OAAe,EACC,KAAa;QAE7B,KAAK,CAAC,yBAAyB,QAAQ,MAAM,OAAO,EAAE,CAAC,CAAC;QAJxC,aAAQ,GAAR,QAAQ,CAAQ;QAEhB,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAE5B;IAEA;IAHlB,YACkB,OAAe,EAC/B,OAAe,EACC,QAAiB;QAEjC,KAAK,CAAC,YAAY,OAAO,aAAa,OAAO,EAAE,CAAC,CAAC;QAJjC,YAAO,GAAP,OAAO,CAAQ;QAEf,aAAQ,GAAR,QAAQ,CAAS;QAGjC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,KAAa;QACvB,KAAK,CAAC,6BAA6B,KAAK,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,OAAe;IACzD,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;QACxC,OAAO,GAAG,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;QAC3C,OAAO,GAAG,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;QACrC,OAAO,uBAAuB,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IAC5D,CAAC;IAED,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;QACxC,OAAO,GAAG,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,GAAG,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACxC,CAAC;IAED,OAAO,GAAG,OAAO,6BAA6B,CAAC;AACjD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Gemini MCP Server - Entry Point
+ *
+ * MCP server for Gemini CLI integration
+ */
+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":";AAEA;;;;GAIG"}

package/dist/index.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+/**
+ * Gemini MCP Server - Entry Point
+ *
+ * MCP server for Gemini CLI integration
+ */
+import chalk from 'chalk';
+import { GeminiMcpServer } from './server.js';
+const SERVER_CONFIG = {
+    name: 'gemini-mcp-server',
+    version: '1.0.0',
+};
+async function main() {
+    try {
+        const server = new GeminiMcpServer(SERVER_CONFIG);
+        await server.start();
+    }
+    catch (error) {
+        console.error(chalk.red('Failed to start server:'), error);
+        process.exit(1);
+    }
+}
+main();
+//# 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;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,aAAa,GAAG;IACpB,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,OAAO;CACjB,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,aAAa,CAAC,CAAC;QAClD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC,EAAE,KAAK,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}