Gemforge MCP

🚀 GemForge (Gemini Tools)

GemForge serves as an enterprise-grade integration solution that bridges Google's Gemini AI with your favorite MCP agents. It empowers agents like Claude, Roo Code, and Windsurf with capabilities such as codebase analysis, live search, and text/PDF/image processing.

🚀 Quick Start

One-Line Install

npx @gemforge/mcp-server@latest init

Manual Setup

1. Create a configuration file (claude_desktop_config.json):

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

2. Install and run:

npm install gemforge-mcp
npm start

Watch 30-second setup demo →

✨ Features

GemForge is the essential bridge between Google's Gemini AI and the MCP ecosystem:

• Real-Time Web Access: Fetch breaking news, market trends, and current data with gemini_search
• Advanced Reasoning: Process complex logic problems with step-by-step thinking via gemini_reason
• Code Mastery: Analyze full repositories, generate solutions, and debug code with gemini_code
• Multi-File Processing: Handle 60+ file formats including PDFs, images, 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

📦 Installation

You can choose either the one-line installation method or set it up manually as described in the Quick Start section.

💻 Usage Examples

Basic Usage

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

Advanced Usage

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

📚 Documentation

Visit our Documentation Site for advanced usage tutorials, API reference, and troubleshooting tips.

🔧 Technical Details

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

Configuration

GemForge offers flexible configuration options:

Deployment

• Smithery.ai: One-click deployment via Smithery.ai
• Docker:

docker run -e GEMINI_API_KEY=your_api_key ghcr.io/pv-bhat/gemforge:latest

• Self-Hosted: Use our MCP.so Directory listing for integration instructions.

📄 License

Licensed under the MIT License. See LICENSE for details.

Community & Support

• Join Us: MCP Discord | GemForge Discord
• Contribute: GitHub Discussions
• Feedback: Open an issue or share thoughts on Discord

Acknowledgments

Powered by the Gemini API and inspired by the Model Context Protocol.