nts: - **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 [Smithery.ai](https://smithery.ai/server/@PV-Bhat/gemforge-gemini-tools-mcp) ### Docker ```bash docker run -e GEMINI_API_KEY=your_api_key ghcr.io/pv-bhat/gemforge:latest ``` ### Self-Hosted Use our [MCP.so Directory listing](https://mcp.so/server/gemforge-gemini-tools-mcp/PV-Bhat) for integration instructions. ## What Sets GemForge Apart? - **Cross-Ecosystem Power**: Bridge Google's AI with Claude and other MCP agents - **Multi-File Analysis**: Compare documents, images, or code versions - **Smart Routing**: Automatic model selection based on task requirements - **Production-Ready**: Built for enterprise environments ![GemForge in Action](docs/assets/gemforge-demo.gif) ## Community & Support - **Join Us**: [MCP Discord](https://discord.me/mcp) | [GemForge Discord](https://discord.gg/yo

GemForge (Gemini Tools)

评论