Gemini MCP Server

Gemini MCP Server

Google の最新 Gemini AI モデルを、お好みの開発環境で利用できる強力な MCP（Model Context Protocol）サーバーです。Gemini 2.5 の思考能力、画像分析、埋め込みなどを、シームレスな連携を通じて利用できます。

🚀 対応クライアント：Claude Desktop、Cursor、Windsurf、および MCP 対応クライアント
🎯 利用する理由：パラメーターをすべて制御しながら、Gemini の最先端 AI 機能を IDE で直接利用できます
📚 自己ドキュメント化：ヘルプシステムを内蔵しているため、エディターを離れる必要はありません

特長

• 強力な 6 つのツール：テキスト生成、画像分析、トークン数のカウント、モデル一覧表示、埋め込み、自己ドキュメント化ヘルプ
• 最新の Gemini モデル：思考能力を備えた Gemini 2.5 シリーズに対応
• 高度な機能：JSON モード、Google 検索グラウンディング、システム指示、会話メモリー
• MCP プロトコルに完全対応：標準の stdio 通信により、あらゆる MCP クライアントとシームレスに連携
• 自己ドキュメント化：ヘルプシステムを内蔵しているため、外部ドキュメントは不要
• TypeScript と ESM：最新の型安全な実装

対応モデル

モデル	コンテキスト	機能	最適な用途
gemini-2.5-pro	2M トークン	思考、JSON、グラウンディング	複雑な推論
gemini-2.5-flash ⭐	1M トークン	思考、JSON、グラウンディング	一般用途
gemini-2.5-flash-lite	1M トークン	思考、JSON	高速な応答
gemini-2.0-flash	1M トークン	JSON、グラウンディング	標準的なタスク
gemini-1.5-pro	2M トークン	JSON	従来モデルのサポート

クイックスタート

1. Gemini API キーを取得する

   • Google AI Studio にアクセスします
   • 新しい API キーを作成します
   • 重要：API キーは安全に保管し、バージョン管理に含めないでください

2. MCP クライアントを設定する

   Claude Desktop

   設定ファイルの場所：

   • Mac：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json

   {
     "mcpServers": {
       "gemini": {
         "type": "stdio",
         "command": "npx",
         "args": ["-y", "github:aliargun/mcp-server-gemini"],
         "env": {
           "GEMINI_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

   Cursor

   Cursor の MCP 設定に追加します：

   {
     "gemini": {
       "type": "stdio",
       "command": "npx",
       "args": ["-y", "github:aliargun/mcp-server-gemini"],
       "env": {
         "GEMINI_API_KEY": "your_api_key_here"
       }
     }
   }
   

   Windsurf

   Windsurf のドキュメントに従って、MCP 設定を行います。

   Other MCP Clients

   標準の MCP stdio 設定を使用します：

   {
     "type": "stdio",
     "command": "npx",
     "args": ["-y", "github:aliargun/mcp-server-gemini"],
     "env": {
       "GEMINI_API_KEY": "your_api_key_here"
     }
   }
   

3. MCP クライアントを再起動する

使い方

設定が完了したら、MCP クライアントで自然言語を使って Gemini の機能を利用できます。

基本コマンド

"Use Gemini to explain quantum computing"
"Analyze this image with Gemini" 
"List all Gemini models"
"Get help on using Gemini"

高度な例

"Use Gemini 2.5 Pro with temperature 0.3 to review this code"
"Use Gemini in JSON mode to extract key points with schema {title, summary, tags}"
"Use Gemini with grounding to research the latest in quantum computing"

📖 使用ガイド全文を見る。詳しい例や高度な機能について説明しています。

Gemini MCP Server を選ぶ理由

• 最新モデルを利用：Google 最先端のモデルである、思考能力を備えた Gemini 2.5 を使用できます
• すべての機能に対応：JSON モード、グラウンディング、システム指示など、Gemini API のすべての機能を利用できます
• 簡単なセットアップ：npx を使った 1 行のインストールで、複雑な設定は不要です
• 本番環境で利用可能：包括的なエラー処理、TypeScript の型、充実したドキュメントを備えています
• 活発な開発：Gemini の新機能のリリースに合わせて、定期的に更新されます

ドキュメント

• 使い方ガイド - すべてのツールと機能の使い方を網羅したガイド
• パラメーターリファレンス - すべてのパラメーターの詳細なドキュメント
• クイックリファレンス - コマンドのクイックチートシート
• 拡張機能 - v4.0.0 の機能の詳細な一覧
• Claude Desktop セットアップガイド - 詳細なセットアップ手順
• 例と使い方 - 使用例と高度な設定
• 実装メモ - 技術的な実装の詳細
• 開発ガイド - 開発者向けガイド
• トラブルシューティングガイド - よくある問題と解決策

ローカル開発

# Clone repository
git clone https://github.com/aliargun/mcp-server-gemini.git
cd mcp-server-gemini

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env and add your GEMINI_API_KEY

# Start development server
npm run dev

貢献

貢献を歓迎します！貢献ガイドをご覧ください。

よくある問題

1. 接続の問題

   • MCP クライアントが正しく再起動されていることを確認してください
   • クライアントのログを確認してください（例：Mac の Claude Desktop の場合は ~/Library/Logs/Claude/mcp-server-gemini.log）
   • インターネット接続を確認してください
   • トラブルシューティングガイドをご覧ください

2. API キーの問題

   • API キーが正しいことを確認してください
   • API キーに適切な権限があることを確認してください
   • キーが環境変数に設定されていることを確認してください
   • セットアップガイドをご覧ください

セキュリティ

• API キーは環境変数のみを介して扱われます
• API キーをバージョン管理にコミットしないでください
• .claude/ ディレクトリは git の対象から除外されています
• 機密データがログに記録されたり保存されたりすることはありません
• セキュリティ更新を定期的に実施しています
• API キーが漏えいした場合は、Google Cloud Console ですぐに再生成してください

ライセンス

MIT