NanoBanana Pro 2

NanoBanana MCP サーバー

NanoBanana Pro 2 を使用した AI 画像生成用の MCP サーバーです。Pro（最高品質）モデルと Flash（高速生成）モデルに対応し、デフォルトの解像度は 4K です。

MCP コミュニティで広く使われている nano-banana の命名規則に着想を得ています。独立した実装です。

クイックインストール

pip install nanobanana-imagen-mcp
# or
uvx nanobanana-imagen-mcp --help

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["nanobanana-imagen-mcp"],
      "env": {
        "GEMINI_API_KEY": "your_key_here"
      }
    }
  }
}

変数	説明	デフォルト
GEMINI_API_KEY	Gemini API キー — すべての生成に必須	--
IMAGE_OUTPUT_DIR	生成画像の保存先ディレクトリ	~/nanobanana-images
NANOBANANA_DB_PATH	画像メタデータ用 SQLite データベースのパス	~/nanobanana-images/images.db

機能

NanoBanana Pro 2 モデルを使用して AI 画像を生成します。テキストからの画像生成、参照画像を使った画像編集、ファイルのアップロード、サーバーのメンテナンスに対応しています。最大 4K 解像度の高品質な画像を生成します。

ツール（4）

ツール	説明
generate_image	NanoBanana Pro 2 を使用して画像を生成します。モデル選択（Pro／Flash）、アスペクト比、解像度（最大 4K）、ネガティブプロンプト、思考レベル、グラウンディング、参照画像、バッチ生成に対応しています。
upload_file	画像編集や条件付けに使用する参照画像をアップロードします。
show_output_stats	生成画像の統計情報（件数、合計サイズ、ファイルの詳細）を表示します。
maintenance	サーバーのメンテナンスとクリーンアップを行います。キャッシュのクリア、一時ファイルの削除、ストレージの最適化ができます。

モデル

モデル	エンジン	最適な用途
Pro	Gemini 3 Pro Image	最高品質、複雑なシーン、フォトリアリズム
Flash	Gemini 3.1 Flash Image	高速生成、シンプルなシーン、素早い試行

設定

変数	説明	デフォルト
GEMINI_API_KEY	Gemini API キー（必須）	--
IMAGE_OUTPUT_DIR	生成画像の出力ディレクトリ	~/nanobanana-images

ストレージ

生成画像のメタデータは SQLite データベースで管理されます。

変数	説明	デフォルト
NANOBANANA_DB_PATH	SQLite メタデータデータベースのパス	~/nanobanana-images/images.db

永続ストレージを無効にするには、NANOBANANA_DB_PATH=:memory: を設定します。サーバー終了時に破棄されるインメモリデータベースを使用します。使い捨て環境や読み取り専用環境に便利です。トレードオフとして、再起動すると画像履歴は失われます。show_output_stats ツールは、セッションごとに空のデータベースを表示します。

データベースと出力ディレクトリは、最初の画像生成時に遅延作成されます。GEMINI_API_KEY を設定せずにサーバーを起動した場合（例：nanobanana-imagen-mcp --help）、ファイルやディレクトリは作成されません。

Claude Desktop の設定

pip から（推奨）

pip install nanobanana-imagen-mcp

{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["nanobanana-imagen-mcp"],
      "env": {
        "GEMINI_API_KEY": "your_key_here"
      }
    }
  }
}

このリポジトリから

{
  "mcpServers": {
    "nanobanana": {
      "command": "python",
      "args": ["-m", "servers.nanobanana.nanobanana_mcp_server.server"],
      "env": {
        "GEMINI_API_KEY": "your_key_here"
      },
      "cwd": "path/to/gemini-media-mcp"
    }
  }
}

特長

• 最大限の精細さを実現するデフォルトの 4K 解像度
• 複雑でフォトリアリスティックなシーン向けの Pro モデル
• 高速な試行やシンプルな被写体向けの Flash モデル
• 複数のアングルで一貫した画像を生成するための参照画像対応
• 品質管理のためのネガティブプロンプト対応
• 複数の要素を含む複雑なシーン向けの思考レベル制御
• 現実世界の被写体向けの Google Search グラウンディング

ライセンス

MIT

クレジット

MCP コミュニティで広く使われている nano-banana の命名規則に着想を得ています。独立した実装です。