[{"_1":2,"_311":-5,"_312":-5},"loaderData",{"_3":4,"_53":54,"_55":56,"_57":58,"_253":254},"root",{"_5":6,"_49":50,"_51":52},"appGlobal",{"_7":8,"_38":39,"_40":41},"config",{"_9":10,"_11":12,"_13":14,"_15":16,"_17":18,"_19":20,"_21":22,"_23":-5,"_24":25,"_26":27,"_28":29,"_30":31,"_32":33,"_34":31,"_35":31,"_36":37},"APP_URL","https://glama.ai","CLIENT_ASSETS_URL","https://static.glama.ai/client/","ENVIRONMENT","LIVE","FACEBOOK_PIXEL_ID","1988603181578092","GOOGLE_ANALYTICS_MEASUREMENT_ID","G-GDQ5NW5CB5","GOOGLE_OAUTH2_CLIENT_ID","48173796263-7ohlqirg28gh2a7nel61coff3m1ogjtc.apps.googleusercontent.com","INTERCOM_APP_ID","wgcqevfz","INTERCOM_USER_HASH","POSTHOG_API_KEY","phc_aK0RnJxBEBRE0h0LIz21yyc9w6ylBxwUHMPB4712Bjc","REDDIT_PIXEL_ID","a2_fcqsoymvje51","RELEASE_VERSION","glama@aa9d1aa3","SENTRY_DRY_RUN",false,"SENTRY_DSN","https://fc82aa9f808b13927ff29c56bda4d486@o4507975513735168.ingest.us.sentry.io/4507975514849280","SENTRY_SPOTLIGHT","SENTRY_TRACE","STRIPE_PUBLIC_KEY","pk_live_51QpZQ32LV3sZcHqzHlFuNhgSfggSNaQqCzZw9EMJ8tbhpQyZgcwQj1vz168FxQ35EGRcztKu2MankxiSs7zLCF4g00blUverGs","viewportWidth",1280,"visitorSession",{"_42":43,"_45":-5,"_46":47,"_48":-5},"attributes",[44],"BOT","membership","uid","lB8qvDYrts","userAccount","nonce","536f5a97d6f2a2e0d60dfdd6d22f71b1","toasts",[],"routes/_public/_layout",{},"routes/_public/mcp/servers/~uid/_layout",{},"routes/_public/mcp/servers/~uid/_pages/_layout",{"_59":-5,"_60":61,"_171":172},"githubUser","mcpServer",{"_62":63,"_64":65,"_42":77,"_84":85,"_86":85,"_87":88,"_93":94,"_116":117,"_118":31,"_119":120,"_113":145,"_146":-5,"_147":-5,"_148":149,"_150":151,"_158":-5,"_159":160,"_165":-5,"_166":-5,"_167":-5,"_46":168,"_169":170},"addedAt",["D",1742045594195],"argumentsJsonSchema",{"_66":67,"_68":69,"_71":72},"type","object","required",[70],"GEMINI_API_KEY","properties",{"_70":73},{"_66":74,"_75":76},"string","description","Your API key for accessing the Gemini API, obtained from Google AI Studio",[78,79,80,81,82,83],"category:search","category:developer-tools","category:other","hosting:remote-capable","language:typescript","license_grade:a","descriptionMarkdown","The ultimate Gemini API interface for MCP hosts, intelligently selecting models for the task at hand—delivering optimal performance, minimal token cost, and seamless integration.","descriptionPlainText","githubProject",{"_89":90,"_91":92},"readme","# GemSuite MCP\n\n

\n\n

\n\n![GemSuite MCP Logo](https://img.shields.io/badge/GemSuite-MCP-2D81FF?style=for-the-badge&logo=googlecloud&logoColor=white)\n

\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![TypeScript](https://img.shields.io/badge/TypeScript-4.9.5-blue?logo=typescript)](https://www.typescriptlang.org/)\n[![MCP](https://img.shields.io/badge/MCP-Compatible-38c7b0?logo=cloudsmith)](https://modelcontextprotocol.ai/)\n[![Smithery](https://img.shields.io/badge/Available%20on-Smithery-6D41A1)](https://smithery.ai/)\n[![Node.js](https://img.shields.io/badge/Node.js-16%2B-339933?logo=node.js)](https://nodejs.org/)\n\n**Professional Gemini API integration for Claude and all MCP-compatible hosts with intelligent model selection and advanced file handling**\n\n*Evolved from the [geminiserchMCP](https://github.com/Lorhlona/geminiserchMCP) project with enhanced capabilities*\n\n[Installation](#installation) • [Features](#key-features) • [Usage](#usage) • [Examples](#usage-examples) • [Models](#model-characteristics) • [Contributing](#contributing)\n\n

\n\n## 🌟 What is GemSuite MCP?\n\nGemSuite MCP is the ultimate Gemini API 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:\n\n1. **Intelligence**: Automatically selects the optimal Gemini model based on task and content\n2. **Efficiency**: Optimizes token usage and performance across different workloads\n3. **Simplicity**: Provides a clean, consistent API for complex AI operations\n4. **Versatility**: Handles multiple file types, operations, and use cases\n\nWhether 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.\n\n## 🚀 Installation\n\n### Option 1: Smithery.ai (Recommended)\n\n```bash\n# Install directly via Smithery CLI\nnpx -y @smithery/cli@latest install gemsuite-mcp --client claude\n```\n\n### Option 2: Manual Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/PV-Bhat/gemsuite-mcp.git\ncd gemsuite-mcp\n\n# Install dependencies\nnpm install\n\n# Set your Gemini API key\necho \"GEMINI_API_KEY=your_api_key_here\" > .env\n\n# Build the project\nnpm run build\n\n# Start the server\nnpm start\n```\n\n## 🔑 API Key Setup\n\n1. Obtain a Gemini API key from [Google AI Studio](https://ai.google.dev/)\n2. Set it as an environment variable:\n ```bash\n export GEMINI_API_KEY=your_api_key_here\n ```\n or create a `.env` file in the project root:\n ```\n GEMINI_API_KEY=your_api_key_here\n ```\n\n## 💎 Key Features\n\n### Unified File Handling\n\n- **Seamless File Processing**: All tools support file inputs via the `file_path` parameter\n- **Automatic Format Detection**: Correct handling of various file types with appropriate MIME types\n- **Multimodal Support**: Process images, documents, code files, and more\n- **Batch Processing**: Support for processing multiple files in a single operation\n\n### Intelligent Model Selection\n\n\n\n\n\n\n

\n\nGemSuite MCP automatically selects the most appropriate Gemini model based on:\n\n- **Task Type**: Search, reasoning, processing, or analysis\n- **Content Type**: Text, code, images, or documents\n- **Complexity**: Simple queries vs. complex reasoning\n- **User Preferences**: Optional manual overrides\n\nThis intelligence ensures optimal performance while minimizing token usage.\n\n

\n\n```mermaid\ngraph TD\n A[Task Request] --> B{Task Type}\n B -->|Search| C[Gemini Flash]\n B -->|Reasoning| D[Gemini Flash Thinking]\n B -->|Processing| E[Gemini Flash-Lite]\n B -->|Analysis| F{File Type}\n F -->|Image| G[Gemini Flash]\n F -->|Code| H[Gemini Flash Thinking]\n F -->|Text| I[Gemini Flash-Lite]\n C & D & E & G & H & I --> J[Execute Request]\n```\n\n

\n\n### Specialized Tools\n\n| Tool | Purpose | Model | Use Cases |\n|------|---------|-------|-----------|\n| **`gem_search`** | Information retrieval with search integration | Gemini Flash | Factual questions, current information, grounded responses |\n| **`gem_reason`** | Complex reasoning with step-by-step analysis | Gemini Flash Thinking | Math, science, coding problems, logical analysis |\n| **`gem_process`** | Fast, efficient content processing | Gemini Flash-Lite | Summarization, extraction, high-volume operations |\n| **`gem_analyze`** | Intelligent file analysis with auto-model selection | Auto-selected | Document analysis, code review, image understanding |\n\n### Robust Error Handling\n\n- **Exponential Backoff**: Graceful handling of API rate limits\n- **Comprehensive Error Detection**: Clear identification of error sources\n- **Actionable Messages**: Detailed error information for troubleshooting\n- **Recovery Mechanisms**: Intelligent fallbacks when primary approaches fail\n\n## 🖥️ Usage\n\n### In Claude or Other MCP-Compatible Hosts\n\nWhen using GemSuite MCP with Claude or other MCP-compatible hosts, the tools will be available directly in the assistant's toolkit. Simply call the appropriate tool for your needs:\n\n#### Tool Selection Guide\n\n- **`gem_search`**: For factual questions requiring search integration\n- **`gem_reason`**: For complex problems requiring step-by-step reasoning\n- **`gem_process`**: For efficient processing of text or files (most token-efficient)\n- **`gem_analyze`**: For detailed analysis of files with automatic model selection\n\n## 📚 Usage Examples\n\n![image](https://github.com/user-attachments/assets/c2fae6de-84e4-4df7-8aab-751626567846)\n#### Claude Desktop Using GemSuite Gemini Search to access Google Search\n\n### Processing Files (Most Token-Efficient)\n\n```javascript\n// Summarize a large document\nconst response = await gem_process({\n file_path: \"/path/to/your/large_document.pdf\",\n operation: \"summarize\"\n});\n\n// Extract specific information\nconst response = await gem_process({\n file_path: \"/path/to/your/report.docx\",\n operation: \"extract\",\n content: \"Extract all financial data and metrics from this document.\"\n});\n```\n\n### Analyzing Files\n\n```javascript\n// Analyze an image\nconst response = await gem_analyze({\n file_path: \"/path/to/your/image.jpg\",\n instruction: \"Describe what you see in this image in detail.\"\n});\n\n// Analyze code\nconst response = await gem_analyze({\n file_path: \"/path/to/your/code.py\",\n instruction: \"Identify potential bugs and suggest optimizations.\"\n});\n```\n\n### Complex Reasoning\n\n```javascript\n// Solve a complex problem with step-by-step reasoning\nconst response = await gem_reason({\n problem: \"Analyze this code and suggest improvements:\",\n file_path: \"/path/to/your/code.js\",\n show_steps: true\n});\n\n// Mathematical problem solving\nconst response = await gem_reason({\n problem: \"Solve this differential equation: dy/dx = 2xy with y(0) = 1\",\n show_steps: true\n});\n```\n\n### Searching with Files\n\n```javascript\n// Answer questions about a document with search integration\nconst response = await gem_search({\n query: \"What companies are mentioned in this document?\",\n file_path: \"/path/to/your/document.pdf\"\n});\n\n// Factual questions with search\nconst response = await gem_search({\n query: \"What are the latest developments in quantum computing?\",\n enable_thinking: true\n});\n```\n\n## 🧠 Model Characteristics\n\nGemSuite MCP leverages three primary Gemini models, intelligently selecting the optimal model for each task:\n\n### Gemini 2.0 Flash\n- **1M token context window**: Process extensive content\n- **Search integration**: Ground responses in current information\n- **Multimodal capabilities**: Handle text, images, and more\n- **Balanced performance**: Good mix of quality and speed\n\n### Gemini 2.0 Flash-Lite\n- **Most cost-efficient**: Minimize token usage\n- **Fastest response times**: Ideal for high-volume operations\n- **Text-focused**: Optimized for text processing\n- **Optimal for efficiency**: When search and reasoning aren't needed\n\n### Gemini 2.0 Flash Thinking\n- **Enhanced reasoning**: Logical analysis and problem-solving\n- **Step-by-step analysis**: Shows reasoning process\n- **Specialized capabilities**: Excels at complex calculations\n- **Best for depth**: When thorough analysis is necessary\n\n## 🔄 Workflow Examples\n\n### Document Analysis Workflow\n\n```javascript\n// 1. Get a high-level summary (most efficient)\nconst summary = await gem_process({\n file_path: \"/path/to/large_document.pdf\",\n operation: \"summarize\"\n});\n\n// 2. Extract specific information\nconst keyPoints = await gem_process({\n file_path: \"/path/to/large_document.pdf\",\n operation: \"extract\",\n content: \"Extract the key findings and recommendations\"\n});\n\n// 3. Answer specific questions with search integration\nconst answers = await gem_search({\n query: \"Based on this document, what are the implications for market growth?\",\n file_path: \"/path/to/large_document.pdf\"\n});\n\n// 4. Claude synthesizes the processed information\n// This approach is dramatically more token-efficient than having\n// Claude process the entire document directly\n```\n\n### Code Review Workflow\n\n```javascript\n// 1. Get code overview\nconst overview = await gem_analyze({\n file_path: \"/path/to/code.js\",\n instruction: \"Provide an overview of this code's structure and purpose\"\n});\n\n// 2. Identify potential issues\nconst issues = await gem_reason({\n problem: \"Analyze this code for bugs, security vulnerabilities, and performance issues\",\n file_path: \"/path/to/code.js\",\n show_steps: true\n});\n\n// 3. Generate improvements\nconst improvements = await gem_reason({\n problem: \"Suggest specific improvements to make this code more efficient and maintainable\",\n file_path: \"/path/to/code.js\",\n show_steps: true\n});\n\n// 4. Claude provides a comprehensive code review synthesis\n```\n\n## 🧩 Integration with Other MCP Hosts\n\nGemSuite MCP works with any MCP-compatible host:\n\n- **Claude Desktop**: Seamless integration with Claude's powerful reasoning capabilities\n- **Cursor IDE**: Enhanced coding assistance with Gemini's capabilities\n- **Replit**: Code generation and analysis directly in your development environment\n- **Other MCP Hosts**: Compatible with any platform implementing the MCP standard\n\n## 🛠️ Advanced Configuration\n\n### Custom Model Selection\n\nYou can override the automatic model selection by specifying the `model_id` parameter:\n\n```javascript\n// Force the use of Gemini Flash Thinking for a processing task\nconst response = await gem_process({\n file_path: \"/path/to/document.pdf\",\n operation: \"analyze\",\n model_id: \"models/gemini-2.0-flash-thinking\"\n});\n```\n\n### Available Operations for `gem_process`\n\n- `summarize`: Create a concise summary\n- `extract`: Extract specific information\n- `restructure`: Reorganize content into a more useful format\n- `simplify`: Make complex content easier to understand\n- `expand`: Add detail or context to content\n- `critique`: Provide critical analysis\n- `feedback`: Offer constructive feedback\n- `analyze`: General analysis of content\n\n## 🔧 Contributing\n\nContributions are welcome! Here's how to get started:\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/my-new-feature`\n3. Make your changes\n4. Run tests: `npm test`\n5. Commit your changes: `git commit -m 'Add my new feature'`\n6. Push to your branch: `git push origin feature/my-new-feature`\n7. Submit a pull request\n\nFor major changes, please open an issue first to discuss what you'd like to change.\n\n## 📜 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgements\n\n- [Lorhlona/geminiserchMCP](https://github.com/Lorhlona/geminiserchMCP) - The original project that inspired this enhanced version\n- [Model Context Protocol](https://modelcontextprotocol.ai) - For developing the MCP standard\n- [Google Gemini](https://ai.google.dev) - For the powerful AI models that power this server\n\n## 🔗 Links\n\n- [GitHub Repository](https://github.com/PV-Bhat/gemsuite-mcp)\n- [Smithery.ai Profile](https://smithery.ai/)\n- [Issue Tracker](https://github.com/PV-Bhat/gemsuite-mcp/issues)\n- [Model Context Protocol](https://modelcontextprotocol.ai/)\n\n---\n\n

\n _{Made with ❤️ by PV-Bhat}\n

\n","url","https://github.com/PV-Bhat/gemsuite-mcp","githubRepository",{"_95":96,"_97":98,"_99":100,"_101":102,"_103":104,"_109":110,"_111":112,"_115":110},"defaultBranch","main","fullName","PV-Bhat/gemsuite-mcp","githubTreeId",87532,"language","TypeScript","owner",{"_105":106,"_107":108},"login","PV-Bhat","verified",true,"recentStargazers",0,"spdxLicense",{"_113":114},"name","MIT License","stargazers","id",1857,"inspectable","integrations",[121,131,138],{"_122":123,"_75":129,"_46":130},"brand",{"_124":125,"_113":126,"_127":128},"logoSvgPath","M12.48 10.92v3.28h7.84c-.24 1.84-.853 3.187-1.787 4.133-1.147 1.147-2.933 2.4-6.053 2.4-4.827 0-8.6-3.893-8.6-8.72s3.773-8.72 8.6-8.72c2.6 0 4.507 1.027 5.907 2.347l2.307-2.307C18.747 1.44 16.133 0 12.48 0 5.867 0 .307 5.387.307 12s5.56 12 12.173 12c3.573 0 6.267-1.173 8.373-3.36 2.16-2.16 2.84-5.213 2.84-7.667 0-.76-.053-1.467-.173-2.053H12.48z","Google","slug","google","Integrates with Google Search to provide grounded responses to factual questions and current information.","zf55wdi9i8",{"_122":132,"_75":136,"_46":137},{"_124":133,"_113":134,"_127":135},"M11.04 19.32Q12 21.51 12 24q0-2.49.93-4.68.96-2.19 2.58-3.81t3.81-2.55Q21.51 12 24 12q-2.49 0-4.68-.93a12.3 12.3 0 0 1-3.81-2.58 12.3 12.3 0 0 1-2.58-3.81Q12 2.49 12 0q0 2.49-.96 4.68-.93 2.19-2.55 3.81a12.3 12.3 0 0 1-3.81 2.58Q2.49 12 0 12q2.49 0 4.68.96 2.19.93 3.81 2.55t2.55 3.81","Google Gemini","google-gemini","Provides intelligent model selection between Gemini 2.0 Flash, Flash-Lite, and Flash Thinking models for different tasks, with file handling and multimodal capabilities.","7iosj8jad8",{"_122":139,"_75":143,"_46":144},{"_124":140,"_113":141,"_127":142},"M2 1.5A1.5 1.5 0 0 1 3.5 0h7A1.5 1.5 0 0 1 12 1.5V8H3.5A1.5 1.5 0 0 1 2 6.5ZM12 8h8.5A1.5 1.5 0 0 1 22 9.5v5a1.5 1.5 0 0 1-1.5 1.5H12ZM2 17.5A1.5 1.5 0 0 1 3.5 16H12v6.5a1.5 1.5 0 0 1-1.5 1.5h-7A1.5 1.5 0 0 1 2 22.5Z","Replit","replit","Enables code generation and analysis directly within the Replit development environment using Gemini's capabilities.","tgfrvp4c5l","GemSuite-MCP","npmPackage","prompts","redditPostForeignId","1jc3dtz","relatedMcpServerIds",[152,153,154,155,156,157],1652,356,1353,548,1115,1739,"resources","scores",{"_161":162,"_163":-5,"_164":-5},"license",100,"quality","security","simpleIcon","supportedPlatforms","tools","m2ljvlatlu","updatedAt",["D",1742079831692],"meta",[173,176,178,185,188,190,193,196,199,202,205,207,210,213,215,217,219,221,223],{"_174":175},"title","GemSuite-MCP | Glama",{"_177":85,"_113":75},"content",{"_179":180,"_181":182,"_183":184},"href","https://glama.ai/mcp/servers/m2ljvlatlu","rel","canonical","tagName","link",{"_177":145,"_186":187},"property","og:title",{"_177":85,"_186":189},"og:description",{"_177":191,"_186":192},"https://glama.ai/logo.png","og:logo",{"_177":194,"_186":195},"https://glama.ai/mcp/servers/m2ljvlatlu/og-image","og:image",{"_177":197,"_186":198},"630","og:image:height",{"_177":200,"_186":201},"1200","og:image:width",{"_177":203,"_186":204},"website","og:type",{"_177":180,"_186":206},"og:url",{"_177":208,"_186":209},"ChatGPT alternative for power users","og:site_name",{"_177":211,"_113":212},"summary_large_image","twitter:card",{"_177":208,"_113":214},"twitter:title",{"_177":85,"_113":216},"twitter:description",{"_177":194,"_113":218},"twitter:image",{"_177":197,"_113":220},"twitter:image:height",{"_177":200,"_113":222},"twitter:image:width",{"_224":225},"script:ld+json",{"_226":227,"_228":229},"@context","http://schema.org","@graph",[230],{"_226":231,"_232":233,"_234":235},"https://schema.org","@type","BreadcrumbList","itemListElement",[236,243,247,251],{"_232":237,"_238":239,"_113":240,"_241":242},"ListItem","item","https://glama.ai/","Glama","position",1,{"_232":237,"_238":244,"_113":245,"_241":246},"https://glama.ai/mcp","MCP",2,{"_232":237,"_238":248,"_113":249,"_241":250},"https://glama.ai/mcp/servers","Servers",3,{"_232":237,"_238":180,"_113":145,"_241":252},4,"routes/_public/mcp/servers/~uid/_pages/reviews/_route",{"_59":-5,"_60":255,"_171":276,"_310":-5},{"_62":256,"_64":257,"_42":261,"_84":85,"_86":85,"_87":262,"_93":263,"_116":117,"_118":31,"_119":266,"_113":145,"_146":-5,"_147":-5,"_148":149,"_150":273,"_158":-5,"_159":274,"_165":-5,"_166":-5,"_167":-5,"_46":168,"_169":275},["D",1742045594195],{"_66":67,"_68":258,"_71":259},[70],{"_70":260},{"_66":74,"_75":76},[78,79,80,81,82,83],{"_89":90,"_91":92},{"_95":96,"_97":98,"_99":100,"_101":102,"_103":264,"_109":110,"_111":265,"_115":110},{"_105":106,"_107":108},{"_113":114},[267,269,271],{"_122":268,"_75":129,"_46":130},{"_124":125,"_113":126,"_127":128},{"_122":270,"_75":136,"_46":137},{"_124":133,"_113":134,"_127":135},{"_122":272,"_75":143,"_46":144},{"_124":140,"_113":141,"_127":142},[152,153,154,155,156,157],{"_161":162,"_163":-5,"_164":-5},["D",1742079831692],[277,279,280,282,284,285,286,287,288,289,290,291,292,293,294,295,296,297,298],{"_174":278},"Reviews | GemSuite-MCP | Glama",{"_177":85,"_113":75},{"_179":281,"_181":182,"_183":184},"https://glama.ai/mcp/servers/m2ljvlatlu/reviews",{"_177":283,"_186":187},"Reviews | GemSuite-MCP",{"_177":85,"_186":189},{"_177":191,"_186":192},{"_177":194,"_186":195},{"_177":197,"_186":198},{"_177":200,"_186":201},{"_177":203,"_186":204},{"_177":281,"_186":206},{"_177":208,"_186":209},{"_177":211,"_113":212},{"_177":208,"_113":214},{"_177":85,"_113":216},{"_177":194,"_113":218},{"_177":197,"_113":220},{"_177":200,"_113":222},{"_224":299},{"_226":227,"_228":300},[301],{"_226":231,"_232":233,"_234":302},[303,304,305,306,307],{"_232":237,"_238":239,"_113":240,"_241":242},{"_232":237,"_238":244,"_113":245,"_241":246},{"_232":237,"_238":248,"_113":249,"_241":250},{"_232":237,"_238":180,"_113":145,"_241":252},{"_232":237,"_238":281,"_113":308,"_241":309},"Reviews",5,"review","actionData","errors"]

Rate & Review