Gemini MCP Server

🚀 Gemini MCP Server for Claude Desktop

Gemini MCP Serverは、Claude DesktopがGoogleのGemini AIモデルを使用して画像を生成できるようにするModel Context Protocol (MCP)サーバーです。このサーバーにより、Claude DesktopのユーザーはGoogleの先進的なAI技術を活用して画像を生成することができます。

✨ 主な機能

• GoogleのGeminiモデルを使用して、Claude Desktopから直接画像を生成できます。
• 設定ウィザードにより、簡単に設定を行うことができます。
• 画像生成パラメータをカスタマイズできます。
• Claude DesktopのMCPサーバーシステムと統合されています。
• 詳細なログ記録とデバッグ機能を備えています。
• Dockerをサポートしており、簡単にデプロイと共有ができます。

📦 インストール

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

npm install -g gemini-mcp-server

# 設定ウィザードを実行
npx gemini-mcp-setup

ローカルインストール

# サーバー用のディレクトリを作成
mkdir gemini-mcp-server
cd gemini-mcp-server

# ローカルにインストール
npm install gemini-mcp-server

# 設定ウィザードを実行
npx gemini-mcp-setup

Dockerインストール

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

# Dockerイメージをビルド
docker build -t gemini-mcp-server .

# Dockerコンテナを実行
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の設定を更新します。

手動で設定したい場合は、以下の手動設定セクションを参照してください。

💻 使用例

基本的な使用法

インストールと設定が完了したら、Claude Desktopを再起動してGemini MCPサーバーを有効にします。その後、以下の手順で画像を生成できます。

1. Claudeと会話を開始します。
2. Claudeに画像生成を依頼します。例えば：
   • "夕日の山並みの風景画像を生成して"
   • "飛行車のある未来都市の絵を作成して"
   • "ピアノを弾く猫のイラストを作って"

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

高度な使用法

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

• スタイル："リアルな"、"アート的な"、"ミニマリストな"などのスタイルを指定できます。
• 温度：生成の創造性/ランダム性を制御します（0.0 - 1.0）。

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

📚 ドキュメント

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

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：カスタムログファイルのパス

設定オプション

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

一般的な問題

サーバーが起動しない、またはClaudeがサーバーに接続できない

1. ~/Claude/logs/gemini-image-mcp.logのログファイルを確認します。
2. APIキーが正しいことを確認します。
3. すべてのディレクトリが存在し、適切な権限を持っていることを確認します。
4. Claude Desktopを再起動します。

画像が生成されない

1. Google Gemini APIキーが正しい権限を持っていることを確認します。
2. 出力ディレクトリが存在し、書き込み可能であることを確認します。
3. ログを調べて、特定のエラーメッセージを確認します。
4. 別のプロンプトまたはモデルを試してみます。

エラー: "Method not found"

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

Docker固有の問題

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

デバッグモード

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

npx gemini-mcp-server --debug

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

export DEBUG=true
npx gemini-mcp-server

📄 ライセンス

MIT

🙏 謝辞

• Model Context Protocol のMCP仕様
• Google Generative AI のGemini API
• このプロジェクトに貢献してくれたすべての方々