mcpField
G
Gemini Nanobanana Mcp

Gemini Nanobanana Mcp

ローカル
github.com/Junhan2AI・エージェント1159 週間前に更新

Gemini Nanobanana Mcp について

Gemini Nanobanana Mcpは、Google Gemini 2.5 Flash ImageをClaudeなどのMCPクライアントから利用できるようにします。テキストや既存画像からの生成・編集・合成に対応し、画像の自動保存も可能です。

主な機能

  1. 01テキストから画像を生成
  2. 02自然言語の指示による画像編集
  3. 03複数画像の合成
  4. 04参照画像のスタイル適用
  5. 05生成画像の自動保存

活用シーン

  1. 01説明文からイラストを作成
  2. 02アップロードした写真を指示に沿って編集
  3. 03複数画像をコラージュに合成
  4. 04参照画像のスタイルを別の画像に適用

MCP 対応

このMCPサーバーは、画像の生成・編集・合成機能をMCPクライアントに提供します。stdioとHTTPのトランスポートに対応します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"gemini-nanobanana": {
"command": "npx",
"args": [
"-y",
"gemini-nanobanana-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"AUTO_SAVE": "<AUTO_SAVE>",
"DEFAULT_SAVE_DIR": "<DEFAULT_SAVE_DIR>",
"LOG_LEVEL": "<LOG_LEVEL>"
}
}
}
}
起動コマンドnpx -y gemini-nanobanana-mcp
設定が必要な環境変数
GEMINI_API_KEYシークレット
AUTO_SAVE
DEFAULT_SAVE_DIR
LOG_LEVEL

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmgemini-nanobanana-mcp

ツール

4

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
promptstringはいシーンを詳細に説明してください。フォトリアリズムを実現するには、写真用語を使用してください。
saveToFilePathstringいいえ画像の保存先パス(任意。拡張子により png/jpeg を選択)

詳細

🎨 Gemini Nanobanana MCP

npm version License: MIT TypeScript Node.js

Claude でテキストから画像を生成しましょう!「かわいい猫を描いて」と入力するだけで、AI が生成した画像をすぐに取得できます。

Google の Gemini 2.5 Flash Image による画像生成機能を Claude の会話に直接追加する、初心者にも使いやすい Model Context Protocol(MCP)サーバーです。

クイックスタート — たった 3 ステップ

1️⃣ API キーを取得する(1 分)
  1. Google AI Studio にアクセスします
  2. Google アカウントでサインインします
  3. 「Create API key」をクリックして、キーをコピーします
2️⃣ Claude クライアントにインストールする(2 分)
Claude Desktop(Windows)
  1. メモ帳を開きます
  2. このコードをコピーし、YOUR_API_KEY を実際のキーに置き換えます:
{
  "mcpServers": {
    "gemini-nanobanana-mcp": {
      "command": "npx",
      "args": ["gemini-nanobanana-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
  1. %APPDATA%/Claude/claude_desktop_config.json として保存します
  2. Claude Desktop を再起動します
Claude Desktop(Mac)
  1. ターミナルを開きます(Spotlight で「Terminal」を検索)
  2. 次のコマンドを実行します(YOUR_API_KEY を置き換えてください):
cat > ~/Library/Application\ Support/Claude/claude_desktop_config.json << 'EOF'
{
  "mcpServers": {
    "gemini-nanobanana-mcp": {
      "command": "npx",
      "args": ["gemini-nanobanana-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
EOF
  1. Claude Desktop を再起動します
Claude Code(最も簡単!)

ターミナルで次のコマンドを実行するだけです(YOUR_API_KEY を置き換えてください):

claude mcp add gemini-nanobanana-mcp -s user -e GEMINI_API_KEY="YOUR_API_KEY" -- npx -y gemini-nanobanana-mcp@latest
Cursor
  1. Cursor Settings → MCP → Add new MCP Server の順に移動します
  2. 次の内容を入力します:
    • Name:gemini-nanobanana-mcp
    • Command:npx
    • Args:gemini-nanobanana-mcp@latest
    • Environment Variables:GEMINI_API_KEY = YOUR_API_KEY
  3. Cursor を再起動します
3️⃣ 作成を始めましょう!(0 分)

Claude で次のように試してみてください:

  • 「庭で遊ぶかわいい子犬を生成して」
  • 「山々に沈む美しい夕日を作成して」
  • 「赤いスポーツカーを描いて」
  • 「抽象的でカラフルな絵を作って」

画像は自動的に ~/Downloads/gemini-images/ に保存されます。


実際の動作を見る

基本的な使い方
You: Generate a cozy coffee shop interior
Claude: [Generating image...]
Image generated and saved to: ~/Downloads/gemini-images/generate-2025-01-09-14-30-45.png
Size: 1.2MB | Format: PNG
保存先を指定する
You: Create a sunset landscape and save it as ./my-sunset.png
Claude: Image saved to: ./my-sunset.png

できること

テキストから画像を生成

テキストで説明するだけで、思い描いたどんな画像でも作成できます。

例:

  • "中世の城の上を飛ぶ威厳あるドラゴン"
  • "植物のあるモダンでミニマルなリビングルーム"
  • "石畳の通りに置かれたビンテージ自転車"
画像の編集

自然言語の指示で既存の画像を編集できます。

使い方:

  • Claude に画像をアップロードします
  • 「この画像を白黒にして」と伝えます
  • または、「この写真に夕日の背景を追加して」と伝えます
画像の合成

複数の画像を組み合わせて、ひとつのクリエイティブな作品を作成できます。

使い方:

  • Claude に 2~10 枚の画像をアップロードします
  • 「これらの画像をコラージュにして」と伝えます
  • または、「これらの写真を芸術的に組み合わせて」と伝えます
スタイルの適用

ある画像の芸術的なスタイルを別の画像に適用できます。

使い方:

  • コンテンツ画像とスタイルの参照画像の 2 枚をアップロードします
  • 「2 枚目の画像のスタイルを 1 枚目に適用して」と伝えます

設定オプション

環境変数
変数デフォルト説明
GEMINI_API_KEY必須Google AI Studio の API キー
AUTO_SAVEtrue保存先が指定されていない場合に画像を自動保存します
DEFAULT_SAVE_DIR~/Downloads/gemini-images画像を保存するデフォルトのディレクトリ
LOG_LEVELinfoログレベル(error、warn、info、debug)

設定をカスタマイズする例:

{
  "mcpServers": {
    "gemini-nanobanana-mcp": {
      "command": "npx",
      "args": ["gemini-nanobanana-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key",
        "AUTO_SAVE": "true",
        "DEFAULT_SAVE_DIR": "~/Pictures/AI-Images",
        "LOG_LEVEL": "debug"
      }
    }
  }
}
自動保存を無効にする

明示的にリクエストした場合にのみ保存するには:

{
  "env": {
    "GEMINI_API_KEY": "your-api-key",
    "AUTO_SAVE": "false"
  }
}

この場合、画像はチャットに表示されるだけで、ディスクには保存されません。


画像の即時プレビュー(Claude Code)

画像の生成後に自動で開くようにしたいですか? Claude Code のフックを設定して、Quick Look で即座にプレビューできるようにしましょう!

ワンクリックセットアップ(Mac)
# Clone this repo and run the installer
git clone https://github.com/nanobanana/nanobanana-mcp.git
cd nanobanana-mcp
bash hooks/install.sh
できること
  • 即時プレビュー:生成された画像が Quick Look で自動的に開きます
  • 手作業ゼロ:ファイルを探して開く必要はありません
  • スマート検出:nanobanana の画像ツールに対してのみ実行されます
  • スペースキーで閉じる:Quick Look の標準コントロールを使用できます

セットアップガイド全文:hooks/README.md


トラブルシューティング

❌ 「GEMINI_API_KEY not set」エラー

解決方法:

  1. YOUR_API_KEY を実際の API キーに置き換えたか、もう一度確認してください
  2. キーの前後に余分なスペースがないことを確認してください
  3. Claude クライアントを完全に再起動してください
  4. Google AI Studio で API キーが機能することを確認してください
「No such file or directory」エラー

解決方法:

  1. nodejs.org から Node.js をインストールしてください(LTS バージョンを選択してください)
  2. ターミナルまたは Claude クライアントを再起動してください
  3. もう一度インストールを試してください
画像が生成されない

確認事項:

  • API キーは正しく設定されていますか?
  • インターネット接続は機能していますか?
  • 設定後に Claude を再起動しましたか?
  • シンプルなプロンプトを試してください:「青い円を生成してください」
画像が自動保存されない

解決方法: 設定に AUTO_SAVE: "true" が含まれていることを確認してください(デフォルトの動作です)。 自動保存を無効にするには、"false" に設定してください。

フックのセットアップが機能しない

よくある解決方法:

  1. Claude Code を使用していることを確認してください(Claude Desktop ではありません)
  2. nanobanana-mcp ディレクトリからインストーラーを実行してください
  3. インストール後に Claude Code を再起動してください
  4. 詳細なトラブルシューティングは hooks/README.md を確認してください

画像をより良くするためのヒント

プロンプト作成のヒント
  • 具体的にする:「ゴールデンレトリバーの子犬」対「犬」
  • スタイルを含める:「水彩画風で」、「フォトリアリスティックに」、「アニメ風で」
  • 詳細を追加する:「青い目で」、「日当たりの良い庭で」、「赤い首輪を着けて」
  • 雰囲気を指定する:「居心地の良い」、「ドラマチックな」、「穏やかな」、「活気のある」
技術的な詳細
  • 対応フォーマット:PNG、JPEG、WebP、GIF
  • デフォルトの出力:PNG 形式
  • 画像サイズ:品質と適切なファイルサイズを両立するよう最適化されています
  • レート制限:リトライロジックで自動的に管理されます

🚀 高度な機能

🔗 HTTP モード(連携向け)

stdio の代わりに HTTP サーバーとして実行します:

MCP_TRANSPORT=http MCP_HTTP_PORT=8080 npx gemini-nanobanana-mcp@latest

http://localhost:8080/mcp でアクセスできます

📊 デバッグログ

詳細なログを有効にします:

{
  "env": {
    "GEMINI_API_KEY": "your-key",
    "LOG_LEVEL": "debug"
  }
}

💡 サポートが必要ですか?

  • 📖 クイックセットアップガイド:QUICK_START.md
  • 🪝 自動プレビューのセットアップ:hooks/README.md
  • 🐛 問題を報告:GitHub Issues
  • 💬 機能リクエスト:ぜひお寄せください!

🤝 貢献

バグを見つけましたか?機能のアイデアがありますか?皆さまの貢献を歓迎します!

  1. リポジトリをフォークします
  2. 機能ブランチを作成します
  3. 変更を加えます
  4. プルリクエストを送信します

📄 ライセンス

MIT ライセンス — ご自身のプロジェクトで自由にお使いください!


⭐ 役に立った場合は、GitHub でリポジトリにスターを付けてください!

Claude コミュニティのために ❤️ を込めて作られました

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。