NanoBridge

GeminiのNano Banana画像生成を、エージェントにMCPサーバーおよびCLIとして接続します。アカウントがすでに持っているGeminiプランを使用するため、画像ごとの請求は発生しません。

nanobridge sprite "a small knight with a blue shield and a silver sword" --size 160

これらの画像はどちらもこのREADMEのコマンドから生成されたものです。スプライトはすでにトリミングされ透明化されており、アニメーションはシートからスライスされ、ループするGIFに組み立てられています。

単にAPIを呼ぶだけではだめな理由

AI StudioのAPIキーは明白な方法ですが、無料プランでは機能しません。無料枠では画像クォータがゼロのため、すべての画像モデルが429 RESOURCE_EXHAUSTEDを返します。課金を有効にすると修正され、画像ごとに課金が始まります。一方、同じアカウントにすでにあるGeminiサブスクリプションは使われないままです。

NanoBridgeは別の扉を開きます。ブラウザと同じように、Chromeにすでにある__Secure-1PSIDクッキーで認証し、サブスクリプションのクォータを消費します。貼り付けるものも、購入するものもありません。

nanobridge doctorは、どちらが有効か、残りクォータがどれだけかを報告します。

Related MCP server: Nano Banana Pro MCP

インストール

git clone https://github.com/NspxMiguel/NanoBridge.git
cd NanoBridge && ./install.sh

インストーラーはvirtualenvを構築し、nanobridgeをPATHに配置し、MCPサーバーをClaude Codeに登録し、エージェントスキルをインストールします。Homebrew:

brew install --cask nspxmiguel/tap/nanobridge

要件: Python 3.11以上、およびhttps://gemini.google.comにサインインしたブラウザ。

シェルから使う

nanobridge doctor                        # backends, quota, config path
nanobridge sprite "a green slime" --style pixel --size 128
nanobridge icon "a compass rose" --style flat
nanobridge gen "a seamless stone wall texture, top-down, tileable"
nanobridge edit hero.png "make the sky stormy, keep everything else"

nanobridge sheet "a green slime" --grid 4x2 \
  --action "squash down and stretch back up, a bouncy idle loop" --fps 10

シートが生成され、フレームにスライスされ、透明性を保持したままループするGIFに組み立てられます。GIFにはアルファチャンネルがないため、空のピクセル用にパレットインデックスが予約されています。

ネットワークに触れない2つのコマンドは、クォータを消費せず、どこからの画像でも動作します:

nanobridge cut photo.jpg --transparent --trim --size 256
nanobridge slice sheet.png --grid 6x1 --size 96

エージェントから使う

MCPサーバーはgenerate_image、generate_sprite、generate_sprite_sheet、generate_icon、edit_image、cut_image、slice_sheet、nanobridge_statusを公開します。

生成ツールはそれぞれ、画像をモデルに返します。512pxプレビューに縮小され、ディスク上のパスとともに返されます。これがポイントです。描いたものを見られないエージェントは、良いスプライトと壊れたスプライトを区別できず、盲目的に反復することになります。

手動で登録する場合:

claude mcp add nanobridge --scope user -- /path/to/.venv/bin/nanobridge mcp

後処理が行うこと

モデルは平らな背景の大きなJPEGを返します。スプライトにはその逆が必要なので、パイプラインは後付けではなくツールの一部です:

• 背景除去は境界接続ベースであり、色一致ではありません。スプライト内の白い目は、その背後にある白と同じ色です。画像の境界に達する領域だけが消去されます。

• トリムは描画に合わせてクロップします。

• リサイズは最近傍法です。スムーズフィルターでリサンプリングされたピクセルアートは、ピクセルアートに見えなくなります。

• スライスは幾何学的です。プロンプトで要求されたグリッドが切断に使用され、個々のフレームが書き出されます。ここでモデルが実際に従ったかどうかがわかります。

言語

画面テキストはポルトガル語と英語です。システムロケールがデフォルトを選択し、nanobridge lang pt|enで選択を保存し、NANOBRIDGE_LANG=ptで1回の実行だけ両方を上書きします。

知っておくべき制限

• Webバックエンドはブラウザセッションに依存します。期限が切れたら、https://gemini.google.comで再度サインインしてください。nanobridge doctorが明示的に通知します。

• Googleが文書化していないインターフェースと通信するため、相手側の変更で壊れる可能性があります。apiバックエンドが、そのまま残るフォールバックです。

• 生成された画像にはGoogleのSynthID透かしが含まれます。

ライセンス

MIT。