and more with `gemini_fileops` - **Intelligent Model Selection**: Automatically routes to optimal Gemini model for each task - **Enterprise-Ready**: Robust error handling, rate limit management, and API fallback mechanisms ## Quick Start ### One-Line Install ```bash npx @gemforge/mcp-server@latest init ``` ### Manual Setup 1. Create configuration file (`claude_desktop_config.json`): ```json { "mcpServers": { "GemForge": { "command": "node", "args": ["./dist/index.js"], "env": { "GEMINI_API_KEY": "your_api_key_here" } } } } ``` 2. Install and run: ```bash npm install gemforge-mcp npm start ``` [Watch 30-second setup demo →](https://www.youtube.com/your-demo-link) ## Heavy-Duty Reliability GemForge is built for production environments: - **Support for 60+ File Types**: Process everything from code to documents to images - **Automatic Model Fallbacks**: Continues functioning even during rate limits or service disruptions - **Enterprise-Grade Error Logging**: Detailed diagnostics for troubleshooting - **API Resilience**: Exponential backoff, retry logic, and seamless model switching - **Full Repository Support**: Analyze entire codebases with configurable inclusion/exclusion patterns - **XML Content Processing**: Specialized handling for structured data ## Key Tools | Tool | Description | Key Capability | |------|-------------|----------------| | `gemini_search` | Web-connected information retrieval | Real-time data access | | `gemini_reason` | Complex problem solving with step-by-step logic | Transparent reasoning process | | `gemini_code` | Deep code understanding and generation | Full repository analysis | | `gemini_fileops` | Multi-file processing across 60+ formats | Document comparison and transformation |

Example: Real-Time Search

```json { "toolName": "gemini_search", "toolParams": { "query": "Latest advancements in quantum computing", "enable_thinking": true } } ```

Example: Code Analysis

```json { "toolName": "gemini_code", "toolParams": { "question": "Identify improvements and new features", "directory_path": "path/to/project", "repomix_options": "--include \"**/*.js\" --no-gitignore" } } ```

Example: Multi-File Comparison

```json { "toolName": "gemini_fileops", "toolParams": { "file_path": ["contract_v1.pdf", "contract_v2.pdf"], "operation": "analyze", "instruction": "Compare these contract versions and extract all significant changes." } } ```

## Configuration GemForge offers flexible configuration options:

Environment Variables

``` GEMINI_API_KEY=your_api_key_here # Required: Gemini API key GEMINI_PAID_TIER=true # Optional: Set to true if using paid tier (better rate limits) DEFAULT_MODEL_ID=gemini-2.5-pro # Optional: Override default model selection LOG_LEVEL=info # Optional: Set logging verbosity (debug, info, warn, error) ```

Claude Desktop Integration

```json { "mcpServers": { "GemForge": { "command": "node", "args": ["./dist/index.js"], "env": { "GEMINI_API_KEY": "your_api_key_here" } } } } ```

Advanced Model Selection

GemForge intelligently selects the best model for each task: - `gemini_search`: Uses `gemini-2.5-flash` for speed and search integration - `gemini_reason`: Uses `gemini-2.5-pro` for deep reasoning capabilities - `gemini_code`: Uses `gemini-2.5-pro` for complex code understanding - `gemini_fileops`: Selects between `gemini-2.0-flash-lite` or `gemini-1.5-pro` based on file size Override with `model_id` parameter in any tool call or set `DEFAULT_MODEL_ID` environment variable.

## Deployment ### Smithery.ai One-click deployment via [Sm

GemForge (Gemini Tools)

Tools