MCP Gemini CrunchTools
MCP Gemini CrunchTools
Google Gemini AI 向けのセキュアな MCP(Model Context Protocol)サーバー - テキスト、画像、動画、リサーチなど。
概要
この MCP サーバーは次のように設計されています:
デフォルトでセキュア - 包括的な脅威モデリング、入力検証、API キー保護
サードパーティサービスなし - stdio 経由でローカル実行され、API キーがマシンの外に出ることはありません
クロスプラットフォーム - Linux、macOS、Windows で動作
自動更新 - GitHub Actions が CVE を監視し、依存関係を更新
コンテナ化 - Hummingbird Python ベースイメージ上に構築された
quay.io/crunchtools/mcp-geminiで利用可能
Related MCP server: Gemini Research MCP Server
命名規則
構成要素 | 名前 |
GitHub リポジトリ | |
コンテナ |
|
Python パッケージ(PyPI) |
|
CLI コマンド |
|
モジュールインポート |
|
Hummingbird を使う理由
コンテナイメージは、Hummingbird Python ベースイメージ(Project Hummingbird 提供)上に構築されており、以下を提供します:
最小限の CVE 露出 - Hummingbird イメージは最小限のパッケージセットで構築されているため、汎用イメージと比較して攻撃対象領域を大幅に削減します
定期的な更新 - セキュリティパッチが迅速に適用され、CVE 数を低く保ちます
Python 向けに最適化 - uv パッケージマネージャーを備えた事前構成済みの Python 環境により、高速で再現性のあるビルドを実現
本番環境対応 - 適切なシグナル処理と非 root ユーザーをデフォルトとした本番ワークロード向け設計
つまり、この MCP サーバーは、一般的な Python コンテナイメージよりも脆弱性が少ない、堅牢化された環境で実行されます。
機能
クエリツール(5 ツール)
gemini_query- 任意の Google 検索グラウンディングを使用して Gemini にクエリを実行gemini_brainstorm- トピックに関する創造的なアイデアを生成gemini_analyze_code- セキュリティ、パフォーマンス、バグについてコードを分析gemini_analyze_text- 感情、トーン、内容についてテキストを分析gemini_summarize- さまざまな形式でコンテンツを要約
画像生成(4 ツール)
gemini_generate_image- テキストプロンプトから画像を生成(ネイティブ Gemini)gemini_generate_image_with_input- 既存の画像を編集/変更gemini_image_prompt- 効果的な画像生成プロンプトを作成gemini_imagen_generate- Google Imagen 4 モデルを使用して画像を生成
画像編集(4 ツール)
gemini_start_image_edit- マルチターンの画像編集セッションを開始gemini_continue_image_edit- アクティブなセッションで編集を継続gemini_end_image_edit- 画像編集セッションを終了gemini_list_image_sessions- アクティブな編集セッションをすべて一覧表示
画像分析(1 ツール)
gemini_analyze_image- ローカル画像ファイルを分析して説明
検索ツール(1 ツール)
gemini_search- Google 検索グラウンディングを使用した Gemini によるウェブ検索
ドキュメントツール(3 ツール)
gemini_analyze_document- PDF、DOCX、TXT などを分析gemini_summarize_pdf- PDF ドキュメントを要約gemini_extract_tables- ドキュメントから表を抽出
URL ツール(3 ツール)
gemini_analyze_url- 1 つ以上の URL を分析gemini_compare_urls- 2 つの URL を比較gemini_extract_from_url- URL から特定のデータを抽出
動画ツール(2 ツール)
gemini_generate_video- Veo を使用して動画を生成gemini_check_video- 動画生成ステータスを確認
YouTube ツール(2 ツール)
gemini_youtube- YouTube 動画を分析gemini_youtube_summary- YouTube 動画を要約
音声ツール(3 ツール)
gemini_speak- テキストを音声に変換gemini_dialogue- 複数音声の対話オーディオを生成gemini_list_voices- 利用可能な音声を一覧表示
リサーチツール(3 ツール)
gemini_deep_research- 複数ステップのウェブリサーチを実行gemini_check_research- リサーチ操作のステータスを確認gemini_research_followup- フォローアップの質問をする
キャッシュツール(4 ツール)
gemini_create_cache- 繰り返しのクエリ用にコンテンツキャッシュを作成gemini_query_cache- キャッシュされたコンテンツにクエリを実行gemini_list_caches- アクティブなキャッシュをすべて一覧表示gemini_delete_cache- キャッシュを削除
構造化出力ツール(2 ツール)
gemini_structured- 構造化された JSON 出力を取得gemini_extract- テキストから構造化データを抽出
トークンツール(1 ツール)
gemini_count_tokens- コンテンツ内のトークンをカウント
コード実行ツール(1 ツール)
gemini_run_code- Gemini 経由で Python コードを実行
合計: 39 ツール
インストール
uvx を使用(推奨)
uvx mcp-gemini-crunchtoolspip を使用
pip install mcp-gemini-crunchtoolsコンテナを使用
# Create a shared output directory (required before first run)
mkdir -p ~/.local/share/mcp-uploads-downloads
podman run -v ~/.local/share/mcp-uploads-downloads:/output:z \
-e GEMINI_API_KEY=your_key \
-e GEMINI_OUTPUT_DIR=/output \
quay.io/crunchtools/mcp-geminiSELinux に関する注意:
:z(小文字、共有)を:Z(大文字、プライベート)の代わりに使用してください。 MCP サーバーは長時間稼働する stdio プロセスとして実行されます。:Zを使用すると、コンテナ起動後にディレクトリへコピーされた ファイルにはコンテナのプライベートな MCS ラベルが付与されず、 コンテナ内から見えなくなります。:zフラグは、すべてのコンテナとホストが読み書きできる共有のcontainer_file_tコンテキストを設定します。ヒント: 同じ共有ディレクトリ(
~/.local/share/mcp-uploads-downloads/)を複数の MCP コンテナサーバー (例: mcp-gemini と mcp-wordpress)間で使用すると、生成された画像をコピーすることなく WordPress のアップロードですぐに利用できます。
構成
Google Gemini API キーの作成
Google AI Studio に移動
Google アカウントでサインイン
API キーを作成
「Get API key」または「Create API key」をクリック
Google Cloud プロジェクトを選択するか、新しいプロジェクトを作成
「Create API key in new project」をクリック(または既存のプロジェクトを選択)
API キーをコピー
重要: API キーはすぐにコピーしてください - 安全に保管しましょう!
キーは
AI...で始まります(例:AIzaSy...)
Claude Code に追加
claude mcp add mcp-gemini-crunchtools \
--env GEMINI_API_KEY=your_api_key_here \
-- uvx mcp-gemini-crunchtoolsまたはコンテナ版の場合:
# Create a shared output directory (required before first run)
mkdir -p ~/.local/share/mcp-uploads-downloads
claude mcp add mcp-gemini-crunchtools \
--env GEMINI_API_KEY=your_api_key_here \
--env GEMINI_OUTPUT_DIR=/output \
-- podman run -i --rm \
-v ~/.local/share/mcp-uploads-downloads:/output:z \
-e GEMINI_API_KEY \
-e GEMINI_OUTPUT_DIR=/output \
quay.io/crunchtools/mcp-gemini任意: 出力ディレクトリの設定(非コンテナ)
コンテナなしで実行する場合の生成画像、音声、動画の出力先:
claude mcp add mcp-gemini-crunchtools \
--env GEMINI_API_KEY=your_api_key_here \
--env GEMINI_OUTPUT_DIR=$HOME/.local/share/mcp-uploads-downloads \
-- uvx mcp-gemini-crunchtools使用例
Google 検索を使用したクエリ
User: What are the latest developments in quantum computing?
Assistant: [calls gemini_query with use_google_search=true]画像を生成
User: Generate a photorealistic image of a sunset over mountains
Assistant: [calls gemini_generate_image with prompt and style]PDF ドキュメントを分析
User: Analyze this research paper at /path/to/paper.pdf
Assistant: [calls gemini_analyze_document with file_path]YouTube 動画を要約
User: Summarize this YouTube video: https://youtube.com/watch?v=...
Assistant: [calls gemini_youtube_summary with url]ディープリサーチ
User: Research the environmental impact of electric vehicles
Assistant: [calls gemini_deep_research then gemini_check_research]コード分析
User: Analyze this Python code for security issues
Assistant: [calls gemini_analyze_code with focus="security"]セキュリティ
このサーバーはセキュリティを最優先に設計されています。以下については SECURITY.md を参照してください:
脅威モデルと攻撃ベクトル
多層防御アーキテクチャ
API キー取り扱いのベストプラクティス
入力検証ルール
監査ログ
主要なセキュリティ機能
API キー保護
SecretStr として保存(誤ってログに記録されることはありません)
環境変数のみ(ファイルや引数には保存されません)
すべてのエラーメッセージからサニタイズされます
入力検証
すべての入力に対する Pydantic モデル
ファイルパス検証
URL 検証
厳密な形式検証
API の堅牢化
ハードコードされた API ベース URL(SSRF を防止)
TLS 証明書の検証
リクエストタイムアウト
レスポンスサイズ制限
CVE の自動スキャン
GitHub Actions が依存関係を毎週スキャン
セキュリティ更新の自動 PR
Dependabot アラート有効
開発
セットアップ
git clone https://github.com/crunchtools/mcp-gemini.git
cd mcp-gemini
uv syncテストを実行
uv run pytestリントと型チェック
uv run ruff check src tests
uv run mypy srcコンテナをビルド
podman build -t mcp-gemini .ライセンス
AGPL-3.0-or-later
コントリビューション
コントリビューションを歓迎します! セキュリティ関連の変更を送信する前に SECURITY.md をお読みください。
リンク
Available Tools
39 toolsgemini_analyze_code_toolGemini Analyze Code ToolCRead-only
Analyze code with Gemini.
Inputs: code (required), focus, model, language. Returns: object
gemini_analyze_document_toolGemini Analyze Document ToolC
Analyze a document (PDF, DOCX, TXT, etc.).
Inputs: file_path (required), model, question. Returns: object
gemini_analyze_image_toolGemini Analyze Image ToolCRead-only
Analyze and describe a local image file.
Inputs: image_path (required), model, query. Returns: object
gemini_analyze_text_toolGemini Analyze Text ToolCRead-only
Analyze text with Gemini.
Inputs: text (required), model, analysis_type. Returns: object
gemini_analyze_url_toolGemini Analyze Url ToolCRead-only
Analyze one or more URLs.
Inputs: urls (required), model, question, use_google_search. Returns: object
gemini_brainstorm_toolGemini Brainstorm ToolCRead-only
Brainstorm ideas on a topic using Gemini.
Inputs: topic (required), model, context, num_ideas. Returns: object
gemini_check_research_toolGemini Check Research ToolCRead-only
Check the status of a deep research operation.
Inputs: research_id (required). Returns: object
gemini_check_video_toolGemini Check Video ToolBRead-only
Check the status of a video generation operation.
Inputs: operation_name (required). Returns: object
gemini_compare_urls_toolGemini Compare Urls ToolCRead-only
Compare two URLs.
Inputs: url1 (required), url2 (required), model, aspect. Returns: object
gemini_continue_image_edit_toolGemini Continue Image Edit ToolC
Continue editing in an active image session.
Inputs: prompt (required), session_id (required). Returns: object
gemini_count_tokens_toolGemini Count Tokens ToolBRead-only
Count the number of tokens in content.
Inputs: content (required), model. Returns: object
gemini_create_cache_toolGemini Create Cache ToolB
Create a content cache for repeated queries.
Upload content once and query it multiple times without re-sending.
Inputs: model, content, file_path, ttl_minutes, +2 more. Returns: object
gemini_deep_research_toolGemini Deep Research ToolB
Start a deep research task using a specialized Gemini model.
Performs multi-step web research to answer complex questions. Completes in a single call; the result is returned immediately.
Inputs: query (required). Returns: object
gemini_delete_cache_toolGemini Delete Cache ToolC
Delete a content cache.
Inputs: cache_name (required). Returns: object
gemini_dialogue_toolGemini Dialogue ToolC
Generate multi-voice dialogue audio.
Inputs: text (required), voice1, voice2. Returns: object
gemini_end_image_edit_toolGemini End Image Edit ToolB
End an image editing session and free resources.
Inputs: session_id (required). Returns: object
gemini_extract_from_url_toolGemini Extract From Url ToolCRead-only
Extract specific data from a URL.
Inputs: url (required), model, data_type, custom_fields. Returns: object
gemini_extract_tables_toolGemini Extract Tables ToolC
Extract tables from a document.
Inputs: file_path (required), model, output_format. Returns: object
gemini_extract_toolGemini Extract ToolCRead-only
Extract structured data from text.
Inputs: text (required), model, extract_type, custom_fields. Returns: object
gemini_generate_image_toolGemini Generate Image ToolB
Generate an image from a text prompt using Gemini's native image model.
Inputs: prompt (required), style, image_size, aspect_ratio, +1 more. Returns: object
gemini_generate_image_with_input_toolGemini Generate Image With Input ToolA
Generate/edit an image using a local image file as input.
Upload a local image and give Gemini instructions for how to modify it. Use cases: add watermarks, change styles, composite images, etc.
Inputs: prompt (required), file_path (required), _aspect_ratio. Returns: object
gemini_generate_video_toolGemini Generate Video ToolB
Generate a video using Veo. Returns an operation ID to poll.
Inputs: prompt (required), _aspect_ratio, negative_prompt. Returns: object
gemini_imagen_generate_toolGemini Imagen Generate ToolA
Generate images using Google Imagen 4 models.
Models (sorted by price):
imagen-4.0-fast-generate-001 ($0.02/image, fastest)
imagen-4.0-generate-001 ($0.04/image, standard)
imagen-4.0-ultra-generate-001 ($0.06/image, highest quality)
Inputs: prompt (required), model, aspect_ratio, number_of_images. Returns: object
gemini_image_prompt_toolGemini Image Prompt ToolCRead-only
Help craft an effective image generation prompt.
Inputs: description (required), mood, model, style. Returns: object
gemini_list_caches_toolGemini List Caches ToolBRead-only
List all active content caches.
Inputs: no named parameters. Returns: object
gemini_list_image_sessions_toolGemini List Image Sessions ToolB
List all active image editing sessions.
Inputs: no named parameters. Returns: object
gemini_list_voices_toolGemini List Voices ToolARead-only
List available voices for text-to-speech.
Inputs: no named parameters. Returns: object
gemini_query_cache_toolGemini Query Cache ToolCRead-only
Query content in a cache.
Inputs: question (required), cache_name (required). Returns: object
gemini_query_toolGemini Query ToolCRead-only
Query Gemini with a prompt. Supports Google Search grounding.
Inputs: prompt (required), model, use_google_search, system_instruction. Returns: object
gemini_research_followup_toolGemini Research Followup ToolBRead-only
Ask a follow-up question about completed research.
Inputs: question (required), research_id (required). Returns: object
gemini_run_code_toolGemini Run Code ToolB
Execute code using Gemini's built-in code execution.
Gemini writes and runs Python code to answer questions, perform calculations, or process data.
Inputs: prompt (required), data, model. Returns: object
gemini_search_toolGemini Search ToolBRead-only
Search the web using Gemini with Google Search grounding.
Inputs: query (required), model. Returns: object
gemini_speak_toolGemini Speak ToolC
Convert text to speech.
Inputs: text (required), voice. Returns: object
gemini_start_image_edit_toolGemini Start Image Edit ToolA
Start a multi-turn image editing session.
Optionally provide an existing image file as the starting point. Without file_path, Gemini generates a new image from the prompt. Use gemini_continue_image_edit_tool to make further edits.
Inputs: prompt (required), file_path, use_google_search. Returns: object
gemini_structured_toolGemini Structured ToolCRead-only
Get structured JSON output from Gemini.
Inputs: prompt (required), model, schema, use_google_search. Returns: object
gemini_summarize_pdf_toolGemini Summarize Pdf ToolC
Summarize a PDF document.
Inputs: file_path (required), model, style. Returns: object
gemini_summarize_toolGemini Summarize ToolCRead-only
Summarize content with Gemini.
Inputs: content (required), model, format, length. Returns: object
gemini_youtube_summary_toolGemini Youtube Summary ToolCRead-only
Summarize a YouTube video.
Inputs: url (required), model, style. Returns: object
gemini_youtube_toolGemini Youtube ToolCRead-only
Analyze a YouTube video.
Inputs: url (required), model, question. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 39 tools
Many tools overlap: multiple image generation/editing tools (gemini_generate_image_tool, gemini_imagen_generate_tool, gemini_generate_image_with_input_tool, gemini_start_image_edit_tool), multiple document analysis tools (analyze_document, summarize_pdf, extract_tables), multiple URL tools (analyze_url, compare_urls, extract_from_url), and general query/analyze/summarize/brainstorm tools. Descriptions help but boundaries are fuzzy, risking misselection.
All tools use snake_case with a consistent 'gemini_' prefix and '_tool' suffix. However, some names lack an action verb (gemini_youtube_tool, gemini_dialogue_tool, gemini_structured_tool) and word order varies (gemini_imagen_generate_tool vs gemini_generate_image_tool), preventing a perfect score.
39 tools is well above the recommended 3-15 range and exceeds the 25-tool threshold for 'too many.' While the server covers many modalities, the count suggests redundant or overly granular tooling that could be consolidated.
The toolset covers a wide range of Gemini capabilities: image/video/audio generation, document/URL/YouTube analysis, research, caching, structured output, token counting, and code execution. Minor gaps exist (e.g., no speech-to-text, no model listing, no embedding generation), but core workflows are well supported.
Maintenance
Related MCP Connectors
Security-first WordPress MCP server. 129 tools for Claude, ChatGPT, Gemini. Free on wp.org.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for Google Veo AI video generation
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Related MCP Servers
- AlicenseAqualityDmaintenanceA 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.1636MIT
- AlicenseAqualityBmaintenanceMCP server for AI-powered research using Gemini. Provides fast grounded web search, deep autonomous research, URL extraction, and session management.988 PyPI10MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for Google Gemini that does not require an API key, combining a CLI backend for Q\&A, research, and analysis with a web UI backend for image and video generation.4 npm3MIT
- AlicenseAqualityCmaintenanceMCP server for Google's Gemini API, enabling text, image, video, speech, embeddings, and deep research capabilities through a single tool set.10MIT