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

命名規則

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 に移動

   • https://aistudio.google.com/apikey にアクセス

   • Google アカウントでサインイン

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 をお読みください。

リンク

• Google Gemini API ドキュメント

• Google AI Studio

• FastMCP ドキュメント

• MCP 仕様

• crunchtools.com