Nano Banana

@mindstone/mcp-server-nano-banana

Nano Banana MCP サーバー — Model Context Protocol を介した Google Gemini の画像生成と編集。テキストの説明から画像を生成したり、Google Gemini の AI 機能を使って既存の画像を編集したりできます。

ステータス

• バージョン: 0.4.1 · npm
• 認証: API キー（GEMINI_API_KEY）
• ツール: 3（画像生成、画像編集）
• 提供形態: クラウド API
• 機械可読: STATUS.json

要件

• Node.js 20+
• npm

ワンクリックインストール

ボタンをクリックすると、ホストから次の値を入力するよう求められます：GEMINI_API_KEY、NANO_BANANA_GEMINI_TIMEOUT_MS、NANO_BANANA_BRIDGE_TIMEOUT_MS。

{
  "mcpServers": {
    "Nano Banana": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-nano-banana"
      ],
      "env": {
        "GEMINI_API_KEY": "",
        "NANO_BANANA_GEMINI_TIMEOUT_MS": "180000",
        "NANO_BANANA_BRIDGE_TIMEOUT_MS": "30000"
      }
    }
  }
}

クイックスタート

インストールとビルド

cd <path-to-repo>/connectors/nano-banana
npm install
npm run build

npx（公開後）

npx -y @mindstone/mcp-server-nano-banana

ローカル

node dist/index.js

設定

環境変数

• GEMINI_API_KEY — Google Gemini API キー
• MCP_WORKSPACE_PATH — 生成した画像の保存先となる任意のワークスペースパス
• MCP_HOST_BRIDGE_STATE — 認証情報の管理に使用するホストブリッジ状態ファイルの任意のパス
• MINDSTONE_REBEL_BRIDGE_STATE — MCP_HOST_BRIDGE_STATE と後方互換性のあるエイリアス
• NANO_BANANA_GEMINI_TIMEOUT_MS — Gemini への送信リクエストのタイムアウトを上書きする任意の設定（正の整数、ミリ秒）。デフォルト：180000（3 分）。gemini-3-pro-image-preview を使用していて、生成に時間がかかると TIMEOUT エラーが発生する場合は値を大きくしてください。上限を短くしたい場合は値を小さくしてください。
• NANO_BANANA_BRIDGE_TIMEOUT_MS — ホストブリッジへのリクエストのタイムアウトを上書きする任意の設定（正の整数、ミリ秒）。デフォルト：30000。

ホスト設定の例

Claude Desktop / Cursor

{
  "mcpServers": {
    "NanoBanana": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-nano-banana"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key"
      }
    }
  }
}

ローカル開発（npm で公開する必要はありません）

{
  "mcpServers": {
    "NanoBanana": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/nano-banana/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key"
      }
    }
  }
}

ツール（3）

設定

• configure_nano_banana_api_key — 画像生成用の Gemini API キーを保存します

画像生成

• nano_banana_generate — テキストの説明から画像を生成します
• nano_banana_edit — AI を使って既存の画像を編集します。複数画像の合成に使用する参照画像を最大 14 枚（source_image_paths）指定できます。各ソースには、ワークスペース内のファイルパスまたは https:// URL を指定できます。各ソースのサイズ上限は画像 1 枚あたり 20MB（ローカルファイルを含む）で、ソース全体の合計サイズにも上限があります。また、リモートからの取得には SSRF 対策が施されており、HTTPS のみ許可され、ユーザー情報を含む URL は拒否されます。プライベート、ループバック、リンクローカルのホストは DNS 再検証により拒否され、リダイレクトは各ホップで再検証されます。対応形式は PNG、JPEG、WebP のみです。

どちらの画像ツールも、ワークスペース内の save_path を任意で指定できます。保存時にファイルが上書きされることはありません。save_path にファイル（またはシンボリックリンク）がすでに存在する場合、画像をインラインで含めたまま SAVE_EXISTS エラーを返します。別のパスを選ぶか、既存のファイルを削除してください。保存されるファイルのアクセス権は所有者のみ（0600）に設定されます。

生成または編集された出力は、返却または保存の前にバイトデータから形式が判定されます。PNG、JPEG、WebP に対応しています。その他の形式や認識できない形式（GIF を含む）の場合、別の形式として扱うのではなく、構造化された UNSUPPORTED_IMAGE_FORMAT エラーを返します。

出力解像度

どちらの画像ツールも、任意の image_size パラメーター（"1K"、"2K"、"4K"。デフォルトは "1K" ≈ 1024px）を受け付けます。高解像度が適用されるのは Gemini 3 の画像モデル（gemini-3.1-flash-image-preview、gemini-3-pro-image-preview）のみです。従来の gemini-2.5-flash-image は常に約 1K の出力を生成し、image_size を明示的に指定するとエラーになります。

ライセンス

FSL-1.1-MIT — Functional Source License, Version 1.1。将来的に MIT ライセンスとなります。本ソフトウェアは 2030-04-08 に MIT ライセンスに移行します。