Skip to main content
Glama

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 リポジトリ

crunchtools/mcp-gemini

コンテナ

quay.io/crunchtools/mcp-gemini

Python パッケージ(PyPI)

mcp-gemini-crunchtools

CLI コマンド

mcp-gemini-crunchtools

モジュールインポート

mcp_gemini_crunchtools

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-crunchtools

pip を使用

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-gemini

SELinux に関する注意: :z(小文字、共有)を :Z(大文字、プライベート)の代わりに使用してください。 MCP サーバーは長時間稼働する stdio プロセスとして実行されます。:Z を使用すると、コンテナ起動後にディレクトリへコピーされた ファイルにはコンテナのプライベートな MCS ラベルが付与されず、 コンテナ内から見えなくなります。:z フラグは、すべてのコンテナとホストが読み書きできる共有の container_file_t コンテキストを設定します。

ヒント: 同じ共有ディレクトリ(~/.local/share/mcp-uploads-downloads/)を複数の MCP コンテナサーバー (例: mcp-gemini と mcp-wordpress)間で使用すると、生成された画像をコピーすることなく WordPress のアップロードですぐに利用できます。

構成

Google Gemini API キーの作成

  1. Google AI Studio に移動

  2. API キーを作成

    • 「Get API key」または「Create API key」をクリック

    • Google Cloud プロジェクトを選択するか、新しいプロジェクトを作成

    • 「Create API key in new project」をクリック(または既存のプロジェクトを選択)

  3. 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 キー取り扱いのベストプラクティス

  • 入力検証ルール

  • 監査ログ

主要なセキュリティ機能

  1. API キー保護

    • SecretStr として保存(誤ってログに記録されることはありません)

    • 環境変数のみ(ファイルや引数には保存されません)

    • すべてのエラーメッセージからサニタイズされます

  2. 入力検証

    • すべての入力に対する Pydantic モデル

    • ファイルパス検証

    • URL 検証

    • 厳密な形式検証

  3. API の堅牢化

    • ハードコードされた API ベース URL(SSRF を防止)

    • TLS 証明書の検証

    • リクエストタイムアウト

    • レスポンスサイズ制限

  4. 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 tools
gemini_analyze_code_toolGemini Analyze Code ToolC
Read-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 ToolC
Read-only

Analyze and describe a local image file.

Inputs: image_path (required), model, query. Returns: object

gemini_analyze_text_toolGemini Analyze Text ToolC
Read-only

Analyze text with Gemini.

Inputs: text (required), model, analysis_type. Returns: object

gemini_analyze_url_toolGemini Analyze Url ToolC
Read-only

Analyze one or more URLs.

Inputs: urls (required), model, question, use_google_search. Returns: object

gemini_brainstorm_toolGemini Brainstorm ToolC
Read-only

Brainstorm ideas on a topic using Gemini.

Inputs: topic (required), model, context, num_ideas. Returns: object

gemini_check_research_toolGemini Check Research ToolC
Read-only

Check the status of a deep research operation.

Inputs: research_id (required). Returns: object

gemini_check_video_toolGemini Check Video ToolB
Read-only

Check the status of a video generation operation.

Inputs: operation_name (required). Returns: object

gemini_compare_urls_toolGemini Compare Urls ToolC
Read-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 ToolB
Read-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 ToolC
Read-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 ToolC
Read-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 ToolC
Read-only

Help craft an effective image generation prompt.

Inputs: description (required), mood, model, style. Returns: object

gemini_list_caches_toolGemini List Caches ToolB
Read-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 ToolA
Read-only

List available voices for text-to-speech.

Inputs: no named parameters. Returns: object

gemini_query_cache_toolGemini Query Cache ToolC
Read-only

Query content in a cache.

Inputs: question (required), cache_name (required). Returns: object

gemini_query_toolGemini Query ToolC
Read-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 ToolB
Read-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 ToolB
Read-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 ToolC
Read-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 ToolC
Read-only

Summarize content with Gemini.

Inputs: content (required), model, format, length. Returns: object

gemini_youtube_summary_toolGemini Youtube Summary ToolC
Read-only

Summarize a YouTube video.

Inputs: url (required), model, style. Returns: object

gemini_youtube_toolGemini Youtube ToolC
Read-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

    C2.8/5.0

    Scored across 39 tools

    Disambiguation2/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers