Skip to main content
Glama
enesjakozh

Gemini MCP Server for Claude Desktop

by Garblesnarff
GitHub
JavaScript
MIT License
13
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Claude デスクトップ用の Gemini MCP サーバー

Claude Desktop が Google の Gemini AI モデルを使用して画像を生成できるようにする Model Context Protocol (MCP) サーバー。

🌟 特徴

  • Google の Gemini モデルを使用して、Claude Desktop から直接画像を生成します。
  • 設定のための簡単なセットアップウィザード
  • カスタマイズ可能な画像生成パラメータ
  • Claude DesktopのMCPサーバーシステムとの統合
  • 詳細なログ記録とデバッグ機能
  • 簡単に導入・共有できるDockerサポート

📋 要件

  • Node.js 16.x 以上
  • クロードデスクトップアプリケーション
  • Google Gemini API キー（こちらから取得）
  • Docker (オプション、コンテナ化されたデプロイメント用)

🚀 インストール

グローバルインストール（推奨）

npm install -g gemini-mcp-server # Run the setup wizard npx gemini-mcp-setup

ローカルインストール

# Create a directory for the server mkdir gemini-mcp-server cd gemini-mcp-server # Install locally npm install gemini-mcp-server # Run the setup wizard npx gemini-mcp-setup

Dockerのインストール

Docker を使用して Gemini MCP サーバーを実行することもできます。

# Build the Docker image docker build -t gemini-mcp-server . # Run the Docker container docker run -e GEMINI_API_KEY="your-api-key" -e OUTPUT_DIR="/app/output" -v /path/on/host:/app/output gemini-mcp-server

⚙️ セットアップ

セットアップ ウィザードが構成プロセスをガイドします。

  1. Google Gemini APIキーを入力してください
  2. 生成された画像を保存するディレクトリを指定する
  3. ログとモデル設定を構成する
  4. Claude Desktop のラッパー スクリプトを自動的に作成する
  5. Claude Desktopの設定を更新する

手動でセットアップする場合は、以下の手動構成セクションを参照してください。

🎨 Gemini MCP サーバーの使用

インストールと設定が完了したら、Claude Desktop を再起動して Gemini MCP サーバーを有効にします。次に、以下の操作を行います。

  1. クロードと会話を始める
  2. Claude に画像を生成するよう依頼します。例:
    • 「夕暮れの山の風景の画像を生成する」
    • 「空飛ぶ車がある未来都市の絵を描きましょう」
    • 「ピアノを弾く猫のイラストを描いてください」

Claude は Gemini API を呼び出して画像を生成し、保存された画像ファイルへのパスを提供します。

詳細オプション

追加のパラメータを使用して画像生成をカスタマイズできます。

  • スタイル: 「リアル」、「芸術的」、「ミニマル」などのスタイルを指定します。
  • 温度: 生成の創造性/ランダム性を制御する (0.0-1.0)

例:「温度 0.7 で、ネオンライトのあるサイバーパンク都市の画像をリアルなスタイルで生成する」

🔧 手動設定

セットアップ ウィザードを使用しない場合は、次の手順に従ってください。

1. 設定ファイルを作成する

設定を含む JSON 構成ファイルを作成します。

{ "apiKey": "YOUR_GEMINI_API_KEY_HERE", "outputDir": "/path/to/your/output/directory", "debug": true, "modelOptions": { "model": "gemini-2.0-flash-exp", "temperature": 0.4 } }

2. ラッパースクリプトを作成する

サーバーを実行するための bash スクリプトを作成します。

#!/bin/bash # Set environment variables export GEMINI_API_KEY="YOUR_GEMINI_API_KEY_HERE" export OUTPUT_DIR="/path/to/your/output/directory" export DEBUG="true" # Execute the server exec "$(which node)" "$(npm root -g)/gemini-mcp-server/bin/gemini-mcp-server.js"

スクリプトを実行可能にします。

chmod +x gemini-mcp-wrapper.sh

3. Claudeデスクトップ構成を更新する

~/.config/claude/claude_desktop_config.jsonファイルを編集して、Gemini MCP サーバーを追加します。

{ "mcpServers": { "gemini-image": { "command": "/bin/bash", "args": [ "-c", "/path/to/your/gemini-mcp-wrapper.sh" ], "env": { "GEMINI_API_KEY": "YOUR_GEMINI_API_KEY_HERE", "DEBUG": "true" } } } }

🐳 Docker デプロイメント

このMCPサーバーには、簡単にデプロイして共有するためのDockerfileが含まれています。Dockerイメージは次のように構成されています。

  • 軽量ベースとしてNode.js 16 Alpineを使用する
  • 必要な依存関係をすべてインストールする
  • /app/outputにデフォルトの出力ディレクトリを設定する
  • 環境変数による設定を許可する

Dockerイメージの構築

docker build -t gemini-mcp-server .

Dockerで実行する

docker run \ -e GEMINI_API_KEY="your-api-key" \ -e OUTPUT_DIR="/app/output" \ -e DEBUG="false" \ -v /path/on/host:/app/output \ gemini-mcp-server

Dockerの環境変数

Docker コンテナを実行するときに、次の環境変数を使用してサーバーを構成できます。

  • GEMINI_API_KEY : Google Gemini API キー（必須）
  • OUTPUT_DIR : 生成された画像を保存するディレクトリ（デフォルト: /app/output ）
  • DEBUG : デバッグログを有効にする (デフォルト: false )

Claude Desktopでの使用

Claude Desktop で Docker コンテナを使用する場合は、次のことが必要です。

  1. コンテナが実行中であることを確認する
  2. コンテナ化されたサーバーに接続するためにClaude Desktopを構成する
  3. 出力ディレクトリをクロードがアクセスできる場所にマップします

📚 APIドキュメント

コマンドラインインターフェース

gemini-mcp-server [options]

オプション:

  • -k, --api-key <key> : Google Gemini API キー
  • -o, --output-dir <dir> : 生成された画像を保存するディレクトリ
  • -d, --debug : デバッグログを有効にする
  • -c, --config <path> : カスタム設定ファイルへのパス
  • -r, --reset-config : 設定をデフォルトにリセットする
  • -v, --version : バージョン情報を表示する

環境変数

  • GEMINI_API_KEY : Google Gemini API キー
  • OUTPUT_DIR : 生成された画像を保存するディレクトリ
  • DEBUG : デバッグログを有効にする（ trueまたはfalse ）
  • LOG_LEVEL : ログレベルを設定する（ ERROR 、 WARN 、 INFO 、またはDEBUG ）
  • GEMINI_LOG_FILE : カスタムログファイルパス

設定オプション

オプション説明デフォルト
apiKeyGoogle Gemini APIキー（必須）
outputDir生成された画像を保存するディレクトリ~/Claude/gemini-images
debugデバッグログを有効にするfalse
modelOptions.model使用するジェミニモデルgemini-2.0-flash-exp
modelOptions.temperature創造性/ランダム性をコントロールする0.4
modelOptions.topKトップkサンプリングパラメータ32
modelOptions.topPトップpサンプリングパラメータ1
modelOptions.maxOutputTokens最大出力トークン8192

🔍 トラブルシューティング

よくある問題

サーバーが起動しない、またはクロードがサーバーに接続できない
  1. ~/Claude/logs/gemini-image-mcp.logのログファイルを確認してください。
  2. APIキーが正しいことを確認してください
  3. すべてのディレクトリが存在し、適切な権限があることを確認する
  4. Claudeデスクトップを再起動します
画像が生成されません
  1. Google Gemini APIキーに正しい権限があることを確認してください
  2. 出力ディレクトリが存在し、書き込み可能であるかを確認します
  3. ログで特定のエラーメッセージを調べる
  4. 別のプロンプトまたはモデルを試してください
エラー:「メソッドが見つかりません」

これは通常、Claude が MCP サーバーがサポートしていないメソッドを呼び出そうとしていることを意味します。ログを確認して、どのメソッドが要求されたかを確認してください。

Docker固有の問題
  1. コンテナが適切なネットワーク接続を持っていることを確認する
  2. ボリュームマウントが正しく構成されているか確認する
  3. 環境変数が適切に設定されていることを確認する
  4. docker logs [container-id]でコンテナのログを確認します

デバッグモード

より詳細なログを取得するには、デバッグ モードを有効にします。

npx gemini-mcp-server --debug

または、環境変数を設定します。

export DEBUG=true npx gemini-mcp-server

📝 ライセンス

マサチューセッツ工科大学

🙏 謝辞

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Claude Desktop がモデル コンテキスト プロトコル (MCP) を通じて Google の Gemini AI モデルを使用して画像を生成できるようにするサーバー。

  1. 🌟 特徴
    1. 📋 要件
      1. 🚀 インストール
        1. グローバルインストール（推奨）
        2. ローカルインストール
        3. Dockerのインストール
      2. ⚙️ セットアップ
        1. 🎨 Gemini MCP サーバーの使用
          1. 詳細オプション
        2. 🔧 手動設定
          1. 1. 設定ファイルを作成する
          2. 2. ラッパースクリプトを作成する
          3. 3. Claudeデスクトップ構成を更新する
        3. 🐳 Docker デプロイメント
          1. Dockerイメージの構築
          2. Dockerで実行する
          3. Dockerの環境変数
          4. Claude Desktopでの使用
        4. 📚 APIドキュメント
          1. コマンドラインインターフェース
          2. 環境変数
          3. 設定オプション
        5. 🔍 トラブルシューティング
          1. よくある問題
          2. デバッグモード
        6. 📝 ライセンス
          1. 🙏 謝辞

            Related MCP Servers

            • Gemini MCP Server

              aliargun
              -
              security
              A
              license
              -
              quality
              Model Context Protocol (MCP) server implementation that enables Claude Desktop to interact with Google's Gemini AI models.
              Last updated -
              191
              JavaScript
              MIT License
              • Apple
              • Linux

            • Gemini MCP Server

              palolxx
              -
              security
              -
              license
              -
              quality
              An MCP server implementation that allows using Google's Gemini AI models (specifically Gemini 1.5 Pro) through Claude or other MCP clients via the Model Context Protocol.
              Last updated -
              1
              JavaScript

            • Gemini MCP Server

              dakrin
              -
              security
              F
              license
              -
              quality
              A Model Context Protocol server that enables Claude Desktop to interact with Google's Gemini 2.5 Pro Experimental AI model, with features like Google Search integration and token usage reporting.
              Last updated -
              3
              JavaScript

            • MCP Gemini Server

              Novakiki
              -
              security
              A
              license
              -
              quality
              An MCP server that enables other AI models (like Claude) to use Google's Gemini models as tools for specific tasks through a standardized interface.
              Last updated -
              1
              TypeScript
              MIT License

            View all related MCP servers

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/Garblesnarff/gemini-mcp-server'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server