Gemini Mcp

MCP Server Gemini

Google の Gemini 3 モデルを Claude Code と連携させ、両方の AI システム間で強力な協業を実現する Model Context Protocol（MCP）サーバーです。美しい CLI も搭載しました！

MCP Registry に対応： 公式 MCP エコシステムで見つけられるようになりました！

特長

特長	説明
ディープリサーチエージェント	ウェブ検索と引用を活用した、自律的な複数ステップの調査
トークン数のカウント	API 呼び出しの前にトークン数を数え、コストを見積もります
テキスト読み上げ	30 種類の音声、単一話者または 2 人の話者による対話
URL 分析	ウェブページを分析、比較し、データを抽出します
コンテキストのキャッシュ	大きなドキュメントをキャッシュし、繰り返しのクエリを効率化します
YouTube 分析	URL とタイムスタンプ指定で動画を分析します
ドキュメント分析	PDF、DOCX、スプレッドシートを分析し、表を抽出します
4K 画像生成	10 種類のアスペクト比で最大 4K の画像を生成します
複数ターンの画像編集	会話を通じて画像を繰り返し調整します
動画生成	Veo 2.0 で動画を作成します（ポーリングによる非同期処理）
コード実行	Gemini が Python コード（pandas、numpy、matplotlib）を作成して実行します
Google 検索	インライン引用付きのリアルタイムなウェブ情報
構造化出力	スキーマ検証付きの JSON レスポンス
データ抽出	テキストからエンティティ、事実、感情を抽出します
思考レベル	推論の深さを制御します（minimal／low／medium／high）
直接クエリ	Gemini 3 Pro／Flash モデルにプロンプトを送信します
ブレインストーミング	Claude と Gemini による協調的な問題解決
コード分析	コードの品質、セキュリティ、パフォーマンスを分析します
要約	詳細度を変えてコンテンツを要約します

---

クイックインストール

Claude Code 用 MCP サーバー

# Using npm (Recommended)
claude mcp add gemini -s user -- env GEMINI_API_KEY=YOUR_KEY npx -y @rlabs-inc/gemini-mcp

# Using bun
claude mcp add gemini -s user -- env GEMINI_API_KEY=YOUR_KEY bunx @rlabs-inc/gemini-mcp

CLI（グローバルインストール）

# Install globally
npm install -g @rlabs-inc/gemini-mcp

# Set your API key once (stored securely)
gcli config set api-key YOUR_KEY

# Now use any command!
gcli search "latest news"
glci image "sunset over mountains" --ratio 16:9

API キーの取得： Google AI Studio にアクセスしてください。無料で、数秒で取得できます！

インストール方法

# With verbose logging
claude mcp add gemini -s user -- env GEMINI_API_KEY=YOUR_KEY VERBOSE=true bunx -y @rlabs-inc/gemini-mcp

# With custom output directory for generated images/videos
claude mcp add gemini -s user -- env GEMINI_API_KEY=YOUR_KEY GEMINI_OUTPUT_DIR=/path/to/output bunx -y @rlabs-inc/gemini-mcp

---

利用可能なツール

gemini-query

思考レベルを制御して Gemini に直接クエリを送信します。

prompt: "Explain quantum entanglement"
model: "pro" or "flash"
thinkingLevel: "low" | "medium" | "high" (optional)

• low：高速なレスポンス、最小限の推論
• medium：バランス型（Flash のみ）
• high：複雑なタスク向けの深い推論（デフォルト）

gemini-generate-image

Nano Banana Pro で画像を生成します（Claude は画像を見られます！）。

prompt: "a futuristic city at sunset"
style: "cyberpunk" (optional)
aspectRatio: "16:9" (1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9)
imageSize: "2K" (1K, 2K, 4K)
useGoogleSearch: false (ground in real-world info)
thinkingLevel: "high" (optional - minimal, low, medium, high)
personGeneration: "ALLOW_ALL" (optional - ALLOW_ALL, ALLOW_ADULT, ALLOW_NONE)
seed: 42 (optional - for reproducible results)

gemini-start-image-edit

複数ターンの画像編集セッションを開始します。

prompt: "a cozy cabin in the mountains"
aspectRatio: "16:9"
imageSize: "2K"
useGoogleSearch: false
thinkingLevel: "high" (optional - minimal, low, medium, high)
personGeneration: "ALLOW_ALL" (optional - ALLOW_ALL, ALLOW_ADULT, ALLOW_NONE)
seed: 42 (optional - for reproducible results)

反復編集に使用するセッション ID を返します。

gemini-continue-image-edit

画像の調整を続けます。

sessionId: "edit-123456789"
prompt: "add snow on the roof and make it nighttime"

gemini-end-image-edit

編集セッションを終了します。

sessionId: "edit-123456789"

gemini-list-image-sessions

アクティブな編集セッションをすべて一覧表示します。

gemini-generate-video

Veo を使用して動画を生成します。

prompt: "a cat playing piano"
aspectRatio: "16:9" (optional)
negativePrompt: "blurry, text" (optional)

動画生成は非同期処理です（1～5 分かかります）。ポーリングには gemini-check-video を使用してください。

gemini-check-video

動画生成の状態を確認し、完了したらダウンロードします。

operationId: "operations/xxx-xxx-xxx"

gemini-analyze-code

コードの問題を分析します。

code: "function foo() { ... }"
language: "typescript" (optional)
focus: "quality" | "security" | "performance" | "bugs" | "general"

gemini-analyze-text

テキストコンテンツを分析します。

text: "Your text here..."
type: "sentiment" | "summary" | "entities" | "key-points" | "general"

gemini-brainstorm

協調的なブレインストーミングを行います。

prompt: "How could we implement real-time collaboration?"
claudeThoughts: "I think we should use WebSockets..."
maxRounds: 3 (optional)

gemini-summarize

コンテンツを要約します：

content: "Long text to summarize..."
length: "brief" | "moderate" | "detailed"
format: "paragraph" | "bullet-points" | "outline"

gemini-run-code

Gemini に Python コードを作成・実行させます：

prompt: "Calculate the first 50 prime numbers and plot them"
data: "optional CSV data to analyze" (optional)

対応ライブラリ：numpy、pandas、matplotlib、scipy、scikit-learn、tensorflow など。 生成されたグラフは出力ディレクトリに保存され、画像として返されます。

gemini-search

リアルタイムのウェブ検索と引用：

query: "What happened in tech news this week?"
returnCitations: true (default)

インライン引用とソース URL を含む、根拠に基づいた回答を返します。

gemini-structured

スキーマに一致する JSON 形式の回答を取得します：

prompt: "Extract the meeting details from this email..."
schema: '{"type":"object","properties":{"date":{"type":"string"},"attendees":{"type":"array"}}}'
useGoogleSearch: false (optional)

gemini-extract

一般的な抽出パターンに便利なツールです：

text: "Your text to analyze..."
extractType: "entities" | "facts" | "summary" | "keywords" | "sentiment" | "custom"
customFields: "name, date, amount" (for custom extraction)

gemini-youtube

YouTube 動画を直接分析します：

url: "https://www.youtube.com/watch?v=..."
question: "What happens at 2:30?"
startTime: "1m30s" (optional, for clipping)
endTime: "5m00s" (optional, for clipping)

gemini-youtube-summary

動画をすばやく要約します：

url: "https://www.youtube.com/watch?v=..."
style: "brief" | "detailed" | "bullet-points" | "chapters"

gemini-analyze-document

PDF やドキュメントを分析します：

filePath: "/path/to/document.pdf"
question: "Summarize the key findings"
mediaResolution: "low" | "medium" | "high"

gemini-summarize-pdf

PDF をすばやく要約します：

filePath: "/path/to/document.pdf"
style: "brief" | "detailed" | "outline" | "key-points"

gemini-extract-tables

ドキュメントから表を抽出します：

filePath: "/path/to/document.pdf"
outputFormat: "markdown" | "csv" | "json"

---

ワークフロー：Claude + Gemini

開発における強力な組み合わせです：

Claude	Gemini
複雑なロジック	フロントエンド／UI
アーキテクチャ	ビジュアルコンポーネント
バックエンドコード	画像生成
統合	React／CSS のスタイリング
推論	クリエイティブな生成

ワークフローの例：

1. Claude にバックエンド API の設計を依頼します
2. gemini-generate-image を使って UI モックアップを作成します
3. gemini-query を使って Gemini に React コンポーネントを生成させます
4. マルチターン編集を使ってビジュアルを調整します
5. Claude にすべてを連携させます

---

環境変数

変数	必須	デフォルト	説明
GEMINI_API_KEY	はい	-	Google Gemini API キー
GEMINI_OUTPUT_DIR	いいえ	./gemini-output	生成ファイルの保存先
GEMINI_MODEL	いいえ	-	初期化テストで使用するモデルを上書き
GEMINI_PRO_MODEL	いいえ	gemini-3-pro-preview	Pro モデル（Gemini 3）
GEMINI_FLASH_MODEL	いいえ	gemini-3-flash-preview	Flash モデル（Gemini 3）
GEMINI_IMAGE_MODEL	いいえ	gemini-3-pro-image-preview	画像モデル（Nano Banana Pro）
GEMINI_IMAGE_THINKING_LEVEL	いいえ	high	画像生成のデフォルトの思考レベル（minimal、low、medium、high）
GEMINI_VIDEO_MODEL	いいえ	veo-2.0-generate-001	動画モデル
VERBOSE	いいえ	false	詳細ログを有効にする
QUIET	いいえ	false	ログを最小限にする
GEMINI_ENABLED_TOOLS	いいえ	-	読み込むツールグループのカンマ区切りリスト（例：query,search,image-gen）
GEMINI_TOOL_PRESET	いいえ	-	プリセットプロファイル：minimal、text、image、research、media、full

---

ツールの設定

デフォルトでは、37 個すべてのツールが読み込まれます。コンテキストの使用量を抑えるには、読み込むツールを設定します：

利用可能なプリセット

プリセット	ツールグループ
minimal	query、brainstorm
text	query、brainstorm、analyze、summarize、structured
image	query、image-gen、image-edit、image-analyze
research	query、search、deep-research、url-context、document
media	query、image-gen、image-edit、image-analyze、video-gen、youtube、speech
full	18 個すべてのツールグループ（デフォルト）

プリセットを使用する

# Minimal - query and brainstorm
GEMINI_TOOL_PRESET=minimal

# Text processing
GEMINI_TOOL_PRESET=text  # query, brainstorm, analyze, summarize, structured

# Image workflows
GEMINI_TOOL_PRESET=image  # query, image-gen, image-edit, image-analyze

# Research workflows
GEMINI_TOOL_PRESET=research  # query, search, deep-research, url-context, document

ツールリストを明示して使用する

# Only specific tools
GEMINI_ENABLED_TOOLS=query,search,image-gen

プリセットと明示的な指定を組み合わせる

# Start with preset, add extras
GEMINI_TOOL_PRESET=minimal
GEMINI_ENABLED_TOOLS=search,image-gen  # Adds to minimal preset

利用可能なツールグループ

グループ	ツール
query	gemini-query
brainstorm	gemini-brainstorm
analyze	gemini-analyze-code, gemini-analyze-text
summarize	gemini-summarize
image-gen	gemini-generate-image, gemini-image-prompt
image-edit	gemini-start-image-edit, gemini-continue-image-edit, gemini-end-image-edit, gemini-list-image-sessions
video-gen	gemini-generate-video, gemini-check-video
code-exec	gemini-run-code
search	gemini-search
structured	gemini-structured, gemini-extract
youtube	gemini-youtube, gemini-youtube-summary
document	gemini-analyze-document, gemini-summarize-pdf, gemini-extract-tables
url-context	gemini-analyze-url, gemini-compare-urls, gemini-extract-from-url
cache	gemini-create-cache, gemini-query-cache, gemini-list-caches, gemini-delete-cache
speech	gemini-speak, gemini-dialogue, gemini-list-voices
token-count	gemini-count-tokens
deep-research	gemini-deep-research, gemini-check-research, gemini-research-followup
image-analyze	gemini-analyze-image

---

手動インストール

グローバルインストール

# Using npm
npm install -g @rlabs-inc/gemini-mcp

# Using bun
bun install -g @rlabs-inc/gemini-mcp

Claude Code の設定

{
  "gemini": {
    "command": "npx",
    "args": ["-y", "@rlabs-inc/gemini-mcp"],
    "env": {
      "GEMINI_API_KEY": "your-api-key",
      "GEMINI_OUTPUT_DIR": "/path/to/save/files"
    }
  }
}

gemini への接続にプロキシが必要な場合は、xxxx を実際のプロキシポートに置き換えてください。

{
  "gemini": {
    "command": "npx",
    "args": ["-y", "@rlabs-inc/gemini-mcp"],
    "env": {
      "GEMINI_API_KEY": "your-api-key",
      "GEMINI_OUTPUT_DIR": "/path/to/save/files",
      "HTTP_PROXY": "http://127.0.0.1:xxxx",
      "HTTPS_PROXY": "http://127.0.0.1:xxxx"
    }
  }
}

---

トラブルシューティング

レート制限（429 エラー）

無料プランでレート制限に達する場合：

• Flash を初期化に使用するため、GEMINI_MODEL=gemini-3-flash-preview を設定してください（より高い上限が適用されます）
• または有料プランにアップグレードしてください

接続の問題

1. Google AI Studio で API キーを確認してください
2. サーバーの状態を確認してください：claude mcp list
3. 詳細ログを有効にして試してください：VERBOSE=true

画像／動画の問題

• API キーで画像／動画の生成が利用できることを確認してください
• 出力ディレクトリのアクセス権を確認してください
• ファイルは GEMINI_OUTPUT_DIR（デフォルト：./gemini-output）に保存されます
• 4K 画像の生成には、より時間がかかります

---

以前のバージョン

0.7.2

美しいテーマを備えた CLI です！ ターミナルから Gemini を直接利用できます：

# Install globally
npm install -g @rlabs-inc/gemini-mcp

# Set your API key once
gcli config set api-key YOUR_KEY

# Generate images, videos, search, research, and more!
gcli image "a cat astronaut" --size 4K
gcli search "latest AI news"
gcli research "quantum computing applications" --wait
gcli speak "Hello world" --voice Puck

美しい 5 つのテーマ： terminal、neon、ocean、forest、minimal

CLI コマンド：

• gcli query - 思考レベルを指定した Gemini への直接クエリ
• gcli search - 引用付きのリアルタイム Web 検索
• gcli research - 深層リサーチエージェント
• gcli image - 画像を生成（最大 4K）
• gcli video - Veo で動画を生成
• gcli speak - 30 種類の音声によるテキスト読み上げ
• gcli tokens - トークン数のカウントとコストの見積もり
• gcli config - 設定の管理

v0.6.x： 深層リサーチ、トークン数のカウント、TTS、URL 分析、コンテキストキャッシュ
v0.5.x： 30 以上のツール、YouTube 分析、ドキュメント分析
v0.4.x： コード実行、Google 検索
v0.3.x： 思考レベル、構造化出力、4K 画像
v0.2.x： Veo による画像／動画生成

---

開発

git clone https://github.com/rlabs-inc/gemini-mcp.git
cd gemini-mcp
bun install
bun run build
bun run dev -- --verbose

スクリプト

コマンド	説明
bun run build	本番用にビルド
bun run dev	ウォッチ機能付きの開発モード
bun run typecheck	出力を生成せずに型をチェック
bun run format	Prettier でフォーマット
bun run lint	ESLint でリント

---

ライセンス

MIT ライセンス

---

Claude と Gemini の連携で作成