-
securityA
license-
qualityThe ultimate Gemini API interface for MCP hosts, intelligently selecting models for the task at hand—delivering optimal performance, minimal token cost, and seamless integration.
Last updated -
22
MIT License
The GemForge-Gemini-Tools-MCP server integrates Google's Gemini AI with the MCP ecosystem, providing AI-powered capabilities through specialized tools:
Real-Time Web Access: Use
gemini_searchto retrieve current information and fact-check dataComplex Problem Solving: Apply
gemini_reasonfor step-by-step solutions to math, science, and coding challengesCode Analysis: Leverage
gemini_codeto analyze codebases, understand structure, and suggest improvementsMulti-File Operations: Process 60+ file formats (text, PDF, images, XML) with
gemini_fileopsfor summarization, extraction, and analysis
Additional features include cross-ecosystem integration with other MCP agents, intelligent model selection based on task requirements, and enterprise-grade reliability with error handling, rate limit management, and automatic fallback mechanisms.
Provides specialized tools for interacting with Google's Gemini AI models, featuring intelligent model selection based on task type, advanced file handling capabilities, and optimized prompts for different use cases such as search, reasoning, code analysis, and file operations.
GemForge (Gemini Tools)
Overview
GemForge-Gemini-Tools-MCP: Enterprise-grade Gemini integration for your favorite MCP agents. Supercharge Claude, Roo Code, and Windsurf with codebase analysis, live search, text/PDF/image processing, and more.
Quick Navigation
Why GemForge?
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_searchAdvanced Reasoning: Process complex logic problems with step-by-step thinking via
gemini_reasonCode Mastery: Analyze full repositories, generate solutions, and debug code with
gemini_codeMulti-File Processing: Handle 60+ file formats including PDFs, images, and more with
gemini_fileopsIntelligent 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
npx @gemforge/mcp-server@latest init
Manual Setup
Create configuration file (
claude_desktop_config.json):
{
"mcpServers": {
"GemForge": {
"command": "node",
"args": ["./dist/index.js"],
"env": {
"GEMINI_API_KEY": "your_api_key_here"
}
}
}
}
Install and run:
npm install gemforge-mcp
npm start
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 |
| Web-connected information retrieval | Real-time data access |
| Complex problem solving with step-by-step logic | Transparent reasoning process |
| Deep code understanding and generation | Full repository analysis |
| Multi-file processing across 60+ formats | Document comparison and transformation |
{
"toolName": "gemini_search",
"toolParams": {
"query": "Latest advancements in quantum computing",
"enable_thinking": true
}
}
{
"toolName": "gemini_code",
"toolParams": {
"question": "Identify improvements and new features",
"directory_path": "path/to/project",
"repomix_options": "--include \"**/*.js\" --no-gitignore"
}
}
{
"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:
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)
{
"mcpServers": {
"GemForge": {
"command": "node",
"args": ["./dist/index.js"],
"env": {
"GEMINI_API_KEY": "your_api_key_here"
}
}
}
}
GemForge intelligently selects the best model for each task:
gemini_search: Usesgemini-2.5-flashfor speed and search integrationgemini_reason: Usesgemini-2.5-profor deep reasoning capabilitiesgemini_code: Usesgemini-2.5-profor complex code understandinggemini_fileops: Selects betweengemini-2.0-flash-liteorgemini-1.5-probased 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
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.
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
Community & Support
Join Us: MCP Discord | GemForge Discord
Contribute: GitHub Discussions
Feedback: Open an issue or share thoughts on Discord
Documentation
Visit our Documentation Site for:
Advanced usage tutorials
API reference
Troubleshooting tips
License
Licensed under the MIT License. See LICENSE for details.
Acknowledgments
Google Gemini API for providing the underlying AI capabilities
Model Context Protocol (MCP) for standardizing AI tool interfaces
Related MCP Servers
- AsecurityAlicenseAqualityA metacognitive pattern interrupt system that helps prevent AI assistants from overcomplicated reasoning paths by providing external validation, simplification guidance, and learning mechanisms.Last updated -2212320MIT License
- AsecurityFlicenseAqualityA server that provides access to Google Gemini AI capabilities including text generation, image analysis, YouTube video analysis, and web search functionality through the MCP protocol.Last updated -694
- Asecurity-licenseAqualityA dedicated server that wraps Google's Gemini AI models in a Model Context Protocol (MCP) interface, allowing other LLMs and MCP-compatible systems to access Gemini's capabilities like content generation, function calling, chat, and file handling through standardized tools.Last updated -1632MIT License