gemsuite

GemSuite MCP is a comprehensive Gemini API integration that automatically selects the optimal Gemini model for each task, while providing a unified toolkit for file handling, processing, and analysis. Once running, you can access four specialized tools directly from MCP-compatible hosts (like Claude): gem_search for information retrieval with factual grounding, gem_reason for step-by-step reasoning on complex problems, gem_process for fast, token-efficient content processing, and gem_analyze for intelligent analysis with automatic model selection. Use these tools to perform tasks such as document analysis, large-file summarization, code review, or multi-file batch processing, all while GemSuite chooses the most appropriate Gemini model to balance quality and cost. To use, invoke the desired tool through your MCP host’s interface or toolkit, passing parameters such as file_path for inputs and operation or instructions specific to each tool, and GemSuite will handle model selection and execution behind the scenes.

Prerequisites:

• Node.js v16+ and npm installed
• Git installed
• A Gemini API key

Option 1: Smithery installation (recommended)

# Install directly via Smithery CLI
npx -y @smithery/cli@latest install @PV-Bhat/gemsuite-mcp --client claude

Option 2: Manual installation

# Clone the repository
git clone https://github.com/PV-Bhat/gemsuite-mcp.git
cd gemsuite-mcp

# Install dependencies
npm install

# Set your Gemini API key
echo "GEMINI_API_KEY=your_api_key_here" > .env

# Build the project
npm run build

# Start the server
npm start

Environment setup (required):

• Create a GEMINI_API_KEY environment variable with your Gemini API key (or place in a .env file as GEMINI_API_KEY=your_api_key_here).
• Ensure network access to Gemini services as required by the server.

Tips and common issues:

• Ensure GEMINI_API_KEY is set before starting the server; without it, API requests will fail.
• If you upgrade Node.js, run npm install to refresh dependencies.
• For file handling, GemSuite supports multiple file types with automatic format detection; ensure file_path inputs point to accessible locations.
• Monitor for rate-limiting; GemSuite includes exponential backoff and robust error handling to mitigate transient API limits.
• If using a custom deployment, consider providing a .env file at the project root with GEMINI_API_KEY and any other environment-specific settings.
• For production, consider containerizing with Docker and mounting environment variables securely.