Gemini Nanobanana Mcp について
Gemini Nanobanana Mcpは、Google Gemini 2.5 Flash ImageをClaudeなどのMCPクライアントから利用できるようにします。テキストや既存画像からの生成・編集・合成に対応し、画像の自動保存も可能です。
主な機能
- 01テキストから画像を生成
- 02自然言語の指示による画像編集
- 03複数画像の合成
- 04参照画像のスタイル適用
- 05生成画像の自動保存
活用シーン
- 01説明文からイラストを作成
- 02アップロードした写真を指示に沿って編集
- 03複数画像をコラージュに合成
- 04参照画像のスタイルを別の画像に適用
MCP 対応
このMCPサーバーは、画像の生成・編集・合成機能をMCPクライアントに提供します。stdioとHTTPのトランスポートに対応します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
4掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| prompt | string | はい | シーンを詳細に説明してください。フォトリアリズムを実現するには、写真用語を使用してください。 |
| saveToFilePath | string | いいえ | 画像の保存先パス(任意。拡張子により png/jpeg を選択) |
詳細
🎨 Gemini Nanobanana MCP
Claude でテキストから画像を生成しましょう!「かわいい猫を描いて」と入力するだけで、AI が生成した画像をすぐに取得できます。
Google の Gemini 2.5 Flash Image による画像生成機能を Claude の会話に直接追加する、初心者にも使いやすい Model Context Protocol(MCP)サーバーです。
クイックスタート — たった 3 ステップ
1️⃣ API キーを取得する(1 分)
- Google AI Studio にアクセスします
- Google アカウントでサインインします
- 「Create API key」をクリックして、キーをコピーします
2️⃣ Claude クライアントにインストールする(2 分)
Claude Desktop(Windows)
- メモ帳を開きます
- このコードをコピーし、
YOUR_API_KEYを実際のキーに置き換えます:
{
"mcpServers": {
"gemini-nanobanana-mcp": {
"command": "npx",
"args": ["gemini-nanobanana-mcp@latest"],
"env": {
"GEMINI_API_KEY": "YOUR_API_KEY"
}
}
}
}
%APPDATA%/Claude/claude_desktop_config.jsonとして保存します- Claude Desktop を再起動します
Claude Desktop(Mac)
- ターミナルを開きます(Spotlight で「Terminal」を検索)
- 次のコマンドを実行します(
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
- 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
Cursor Settings→MCP→Add new MCP Serverの順に移動します- 次の内容を入力します:
- Name:
gemini-nanobanana-mcp - Command:
npx - Args:
gemini-nanobanana-mcp@latest - Environment Variables:
GEMINI_API_KEY=YOUR_API_KEY
- Name:
- 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_SAVE | true | 保存先が指定されていない場合に画像を自動保存します |
DEFAULT_SAVE_DIR | ~/Downloads/gemini-images | 画像を保存するデフォルトのディレクトリ |
LOG_LEVEL | info | ログレベル(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」エラー
解決方法:
YOUR_API_KEYを実際の API キーに置き換えたか、もう一度確認してください- キーの前後に余分なスペースがないことを確認してください
- Claude クライアントを完全に再起動してください
- Google AI Studio で API キーが機能することを確認してください
「No such file or directory」エラー
解決方法:
- nodejs.org から Node.js をインストールしてください(LTS バージョンを選択してください)
- ターミナルまたは Claude クライアントを再起動してください
- もう一度インストールを試してください
画像が生成されない
確認事項:
- API キーは正しく設定されていますか?
- インターネット接続は機能していますか?
- 設定後に Claude を再起動しましたか?
- シンプルなプロンプトを試してください:「青い円を生成してください」
画像が自動保存されない
解決方法:
設定に AUTO_SAVE: "true" が含まれていることを確認してください(デフォルトの動作です)。
自動保存を無効にするには、"false" に設定してください。
フックのセットアップが機能しない
よくある解決方法:
- Claude Code を使用していることを確認してください(Claude Desktop ではありません)
- nanobanana-mcp ディレクトリからインストーラーを実行してください
- インストール後に Claude Code を再起動してください
- 詳細なトラブルシューティングは 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
- 💬 機能リクエスト:ぜひお寄せください!
🤝 貢献
バグを見つけましたか?機能のアイデアがありますか?皆さまの貢献を歓迎します!
- リポジトリをフォークします
- 機能ブランチを作成します
- 変更を加えます
- プルリクエストを送信します
📄 ライセンス
MIT ライセンス — ご自身のプロジェクトで自由にお使いください!
⭐ 役に立った場合は、GitHub でリポジトリにスターを付けてください!
Claude コミュニティのために ❤️ を込めて作られました
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。