nano-banana

Nano Banana - MCP による AI 画像生成

MCP を介して Google の Gemini 画像モデルを使用し、美しい 4K 画像の生成、写真の編集、テキストを正確に描画したグラフィックの作成ができます。デフォルトモデルは gemini-3.1-flash-image-preview（Nano Banana 2）で、2026 年 2 月にリリースされました。

使用する場面

ユーザーが次のことを求めた場合に呼び出します：

• 「画像を生成して」や「絵を作って」と依頼する
• 「この写真を編集して」や「この画像を変更して」と希望する
• テキスト入りのグラフィック（ロゴ、インフォグラフィック、図）が必要
• 複数の画像にわたって「一貫性のあるキャラクター」を希望する
• 「これを視覚化して」や「［ビジュアル要素］を作って」と依頼する

前提条件

1. Gemini API キー

Google AI Studio で無料の API キーを取得します：

1. Google アカウントでサインインします
2. 「Get API Key」→「Create API Key」をクリックします
3. コピーして安全に保存します

2. MCP サーバーのセットアップ

推奨：NanoBanana-MCP（最高品質を実現する Gemini 3.1 Flash Image を使用）

# Quick install via Claude Code CLI
claude mcp add nano-banana --env GEMINI_API_KEY=your-key-here -- npx -y nanobanana-mcp

または、~/.claude/settings.json に手動で追加します：

{
  "mcpServers": {
    "nano-banana": {
      "command": "npx",
      "args": ["-y", "nanobanana-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

代替案：ConechoAI の Nano-Banana-MCP（Gemini 2.0 Flash — より高速、低コスト）

{
  "mcpServers": {
    "nano-banana": {
      "command": "npx",
      "args": ["nano-banana-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

利用可能なツール

MCP を設定すると、次のツールを利用できるようになります：

コアツール

ツール	目的	主なパラメーター
gemini_generate_image	テキストプロンプトから新しい画像を作成します	prompt、model、aspectRatio、imageSize
gemini_edit_image	指示に従って既存の画像を変更します	imagePath、instructions、model
continue_editing	最後に生成した画像を調整します	instructions
get_image_history	セッション内で生成したすべての画像を一覧表示します	-

モデルのオプション

モデル ID	説明
gemini-3.1-flash-image-preview	デフォルト。 最高品質、4K 対応、最高のテキスト描画性能（Nano Banana 2、2026 年 2 月リリース）
gemini-2.5-flash-image-preview	高速生成、1K 解像度、良好な品質（Nano Banana）
gemini-3-pro-image-preview	前世代の Pro モデル。現在も高品質です（Nano Banana Pro）
gemini-2.0-flash-exp	古い実験的モデルです。新規作業では gemini-2.5-flash-image-preview を推奨します

画像サイズ（Gemini 3.1 / 3 のみ）

サイズ	使用例
4K	最終成果物、印刷物、マーケティング資料
2K	品質と速度のバランス
1K	高速な反復、プロトタイピング

高度な機能

機能	能力
4K 出力	最大 5632×3072 ピクセル
テキスト描画	画像内のテキストを正確に描画（看板、ラベル、UI）
複数画像の合成	最大 14 枚の参照画像を組み合わせ
キャラクターの一貫性	5 枚以上の画像で同じキャラクターを維持
Google 検索によるグラウンディング	現実世界に即した正確な画像

プロンプト作成のベストプラクティス

プロンプトを構成する

[Subject] + [Style] + [Details] + [Technical Specs]

例：

「居心地のよいコーヒーショップの店内、水彩画風、暖かな照明、木製家具、テーブルの上に湯気の立つカップ、4K 解像度、窓から差し込む柔らかな朝の光」

最良の結果を得るには

1. 具体的にする - 色、素材、照明、雰囲気を含めます
2. スタイルを指定する - 「フォトリアル」、「油絵」、「3D レンダリング」、「アニメ」
3. コンテキストを追加する - 時刻、天気、場所
4. 解像度を指定する - 「4K」、「高解像度」、「詳細」

精密モード（JSON プロンプト）

正確な再現性が求められる重要な作業には、構造化された JSON スキーマを使用します。

使用を開始する場面

次のようなフレーズがトリガーになります：

• 「……を正確に制御したい」
• 「［ブランド］の製品写真を作成して」
• 「UI のモックアップを生成して」
• 「……を示すインフォグラフィックを作って」
• 「照明だけを変えながら反復したい」
• 「異なるバージョンで A/B テストをしたい」

3 種類のスキーマ

種類	使用例	主な制御項目
marketing_image	製品写真、ヒーロー画像	主題、小道具、照明、カメラ、ブランドの固定要素
ui_builder	アプリ画面、ダッシュボード	トークン、画面、コンテナ、コンポーネント
diagram_spec	フローチャート、インフォグラフィック	ノード、エッジ、データ制約

翻訳ワークフロー

1. 説明 - ユーザーが希望する内容を平易な英語で説明します
2. 確認 - Claude が不足している項目について具体的な質問をします
3. 生成 - Claude が構造化された JSON スキーマを出力します
4. レビュー - ユーザーが主要な項目が意図と一致しているか確認します
5. レンダリング - JSON を Nano Banana 2 向けの正確なプロンプトに変換します
6. 反復 - 特定の項目を変更し、再レンダリングします（変更範囲を限定）

例：製品写真

ユーザー：「Aurora Lime の炭酸水のヒーローショットが必要です」

Claude の質問：「Aurora Lime のヒーローショットについて：

1. 缶のサイズは？（標準の 12oz ですか？）
2. 小道具は？（ライムのスライス、氷、結露など）
3. 背景のスタイルは？（単色、グラデーション、ボケなど）
4. 照明の雰囲気は？（明るく爽やか、またはムーディーで高級感のある雰囲気など）」

結果： 項目ごとに反復して調整できる、正確な仕様を含む構造化 JSON。

範囲を限定した編集（重要なポイント）

JSON を使えば、すべてを再生成せずに 1 つの要素だけを変更できます：

変更内容	固定されるもの
照明の方向を変更	被写体、小道具、背景
カメラアングルを変更	照明、小道具、環境
背景色を変更	被写体の形状、照明の設定
小道具を追加／削除	その他すべて

参考ドキュメント

• references/json-prompting.md - JSON プロンプトの完全ガイド
• references/translator-prompt.md - 翻訳システムのプロンプト
• references/schemas/ - 種類ごとのテンプレートスキーマ
• references/examples-json.md - 記入済みの例

画像内のテキスト

Nano Banana 2 はテキストのレンダリングに優れています：

「『COSMIC ADVENTURE』の大胆なレトロタイポグラフィ、星空の背景、宇宙飛行士のシルエット、1970 年代の SF 風の雰囲気を取り入れたビンテージ映画ポスター」

キャラクターの一貫性

画像間でキャラクターの一貫性を保つには：

1. 詳細な説明を使って最初のキャラクターを生成します
2. 以降のプロンプトで history:0 の参照を使用します
3. 元のキャラクターを参照しながら、シーンの変更点を説明します

First: "A young woman with red curly hair, freckles, green eyes, wearing a blue jacket"
Then: "The same woman from history:0, now sitting at a café, reading a book"

ワークフローの例

基本的な画像生成

User: "Create an image of a futuristic city at sunset"

Claude uses: gemini_generate_image
Prompt: "Futuristic cityscape at golden hour sunset, towering glass skyscrapers with holographic advertisements, flying vehicles, warm orange and purple sky, photorealistic, 4K resolution, cinematic lighting"

写真編集

User: "Edit this photo to make it look like winter"

Claude uses: gemini_edit_image
Input: [user's image path]
Instructions: "Transform to winter scene: add snow on ground and surfaces, frost on windows, visible breath, overcast sky, cool blue color grading"

反復的な調整

User: "Make the lighting warmer"

Claude uses: continue_editing
Instructions: "Adjust lighting to warmer tones, add golden hour glow, enhance orange/yellow highlights, softer shadows"

出力の管理

画像の保存先：~/Documents/nanobanana_generated/

命名形式：generated-[timestamp]-[id].png

セキュリティに関する注意

• API キーは環境変数にローカル保存されます
• バージョン管理にはコミットされません
• 画像はローカルで処理され、外部サーバーには保存されません
• プロジェクトでのキー管理には .env ファイルを使用します

モデルの比較

モデル	速度	品質	最大解像度	コスト	最適な用途
gemini-3.1-flash-image-preview	高速	最高	4K	約 $0.045/枚（1K）	最終アセット、印刷、マーケティング
gemini-2.5-flash-image-preview	最速	良好	1K	約 $0.039/枚	プロトタイプ作成、反復、下書き
gemini-3-pro-image-preview	やや低速	高い	4K	約 $0.134/枚	旧世代 Pro の代替
gemini-2.0-flash-exp	高速	良好	1K	低	レガシー。代わりに 2.5-flash-image-preview を使用してください

2026 年 3 月時点の価格です。 すべてのモデルで Google AI Studio 経由の無料枠（約 500 リクエスト／日）を利用できます。

トラブルシューティング

問題	解決策
「API キーが無効です」	AI Studio でキーを確認してください
「レート制限に達しました」	60 秒待つか、API プランをアップグレードしてください
「MCP に接続されていません」	Claude Code を再起動し、設定構文を確認してください
「画像が保存されません」	出力ディレクトリへの書き込み権限を確認してください

連携

以下と組み合わせて使うと効果的です：

• Artifacts Builder - HTML アーティファクト用の画像を生成
• Process Mapper - 図のビジュアルを作成
• Research to Essay - コンテンツにイラストを追加

参考資料

• references/prompting-guide.md - プロンプト作成の詳しいテクニック
• references/examples.md - カテゴリ別のプロンプト例