PV-Bhat/gemsuite-mcp

The ultimate open-source server for advanced Gemini API interaction with Model Context Protocol (MCP), intelligently selecting models for optimal performance, minimal token cost, and seamless integration.
**Professional Gemini API integration for Claude and all MCP-compatible hosts with intelligent model selection and advanced file handling**
*Evolved from the geminiserchMCP project with enhanced capabilities*
Installation • Features • Usage • Examples • Models • Contributing
🌟 What is GemSuite MCP?
GemSuite (Model Context Protoco) MCP is the ultimate Gemini API integration interface for MCP hosts, intelligently selecting models for the task at hand—delivering optimal performance, minimal token cost, and seamless integration. It enables any MCP-compatible host (Claude, Cursor, Replit, etc.) to seamlessly leverage Gemini's capabilities with a focus on:
1. **Intelligence**: Automatically selects the optimal Gemini model based on task and content
2. **Efficiency**: Optimizes token usage and performance across different workloads
3. **Simplicity**: Provides a clean, consistent API for complex AI operations
4. **Versatility**: Advanced file handling; Handles multiple file types, operations, and use cases
Whether you're analyzing documents, solving complex problems, processing large text files, or searching for information, GemSuite MCP provides the right tools with the right models for the job.
Why GemSuite MCP?
Unlike other Gemini MCP servers that offer limited functionality, GemSuite MCP provides:
✅ **Intelligent Model Selection**: Automatically selects the optimal Gemini model based on task
✅ **Unified File Handling**: Seamlessly processes various file types with automatic format detection
✅ **Comprehensive Tool Suite**: Four specialized tools covering search, reasoning, processing, and analysis
✅ **Production-Ready**: Deployed and validated on Smithery.ai, MCP.so, and Glama.io
🚀 Installation
Option 1: Smithery.ai (Recommended)
Option 2: Manual Installation
🔑 API Key Setup
1. Obtain a Gemini API key from Google AI Studio
2. Set it as an environment variable:
or create a .env file in the project root:
💎 Key Features
Unified File Handling
- **Seamless File Processing**: All tools support file inputs via the file_path parameter
- **Automatic Format Detection**: Correct handling of various file types with appropriate MIME types
- **Multimodal Support**: Process images, documents, code files, and more
- **Batch Processing**: Support for processing multiple files in a single operation
Intelligent Model Selection
GemSuite MCP automatically selects the most appropriate Gemini model based on:
- **Task Type**: Search, reasoning, processing, or analysis
- **Content Type**: Text, code, images, or documents
- **Complexity**: Simple queries vs. complex reasoning
- **User Preferences**: Optional manual overrides
This intelligence ensures optimal performance while minimizing token usage.
Specialized Tools
| Tool | Purpose | Model | Use Cases |
|------|---------|-------|-----------|
| **gem_search** | Information retrieval with search integration | Gemini Flash | Factual questions, current information, grounded responses |
| **gem_reason** | Complex reasoning with step-by-step analysis | Gemini Flash Thinking | Math, science, coding problems, logical analysis |
| **gem_process** | Fast, efficient content processing | Gemini Flash-Lite | Summarization, extraction, high-volume operations |