MCP Gemini CrunchTools
A secure MCP (Model Context Protocol) server for Google Gemini AI - text, image, video, research, and more.
Overview
This MCP server is designed to be:
- Secure by default - Comprehensive threat modeling, input validation, and API key protection
- No third-party services - Runs locally via stdio, your API key never leaves your machine
- Cross-platform - Works on Linux, macOS, and Windows
- Automatically updated - GitHub Actions monitor for CVEs and update dependencies
- Containerized - Available at
quay.io/crunchtools/mcp-gemini built on Hummingbird Python base image
Naming Convention
| Component | Name |
|-----------|------|
| GitHub repo | crunchtools/mcp-gemini |
| Container | quay.io/crunchtools/mcp-gemini |
| Python package (PyPI) | mcp-gemini-crunchtools |
| CLI command | mcp-gemini-crunchtools |
| Module import | mcp_gemini_crunchtools |
Why Hummingbird?
The container image is built on the Hummingbird Python base image from Project Hummingbird, which provides:
- Minimal CVE exposure - Hummingbird images are built with a minimal package set, dramatically reducing the attack surface compared to general-purpose images
- Regular updates - Security patches are applied promptly, keeping CVE counts low
- Optimized for Python - Pre-configured Python environment with uv package manager for fast, reproducible builds
- Production-ready - Designed for production workloads with proper signal handling and non-root user defaults
This means your MCP server runs in a hardened environment with fewer vulnerabilities than typical Python container images.
Features
Query Tools (5 tools)
gemini_query - Query Gemini with optional Google Search groundinggemini_brainstorm - Generate creative ideas on a topicgemini_analyze_code - Analyze code for security, performance, bugsgemini_analyze_text - Analyze text for sentiment, tone, contentgemini_summarize - Summarize content in various formats
Image Generation (4 tools)
gemini_generate_image - Generate images from text prompts (native Gemini)gemini_generate_image_with_input - Edit/modify existing imagesgemini_image_prompt - Craft effective image generation promptsgemini_imagen_generate - Generate images using Google Imagen 4 models
Image Editing (4 tools)
gemini_start_image_edit - Start a multi-turn image editing sessiongemini_continue_image_edit - Continue editing in an active sessiongemini_end_image_edit - End an image editing sessiongemini_list_image_sessions - List all active editing sessions
Image Analysis (1 tool)
gemini_analyze_image - Analyze and describe local image files
Search Tools (1 tool)
gemini_search - Web search using Gemini with Google Search grounding
Document Tools (3 tools)
gemini_analyze_document - Analyze PDFs, DOCX, TXT, etc.gemini_summarize_pdf - Summarize PDF documentsgemini_extract_tables - Extract tables from documents
URL Tools (3 tools)
gemini_analyze_url - Analyze one or more URLsgemini_compare_urls - Compare two URLsgemini_extract_from_url - Extract specific data from a URL
Video Tools (2 tools)
gemini_generate_video - Generate videos using Veogemini_check_video - Check video generation status
YouTube Tools (2 tools)
gemini_youtube - Analyze YouTube videosgemini_youtube_summary - Summarize YouTube videos
Voice Tools (3 tools)
gemini_speak - Convert text to speechgemini_dialogue - Generate multi-voice dialogue audiogemini_list_voices - List available voices
Research Tools (3 tools)
gemini_deep_research - Perform multi-step web researchgemini_check_research - Check research operation status- `gemini_resear
... View full README on GitHub
