Nano Banana by Ace Data Cloud

Ace Data Cloud の Nano Banana

簡体字中国語のインストールと初回利用ガイド

AceDataCloud APIを通じてGoogleのNano Bananaモデルを使用し、AI画像の生成と編集を行うためのModel Context Protocol（MCP）サーバーです。

Claude、VS Code、またはMCP互換クライアントから直接、AI画像を生成・編集できます。

GlamaでNano Bananaを使用する

Aceが提供するNano Bananaのソースリストまたはリモートコネクターをご確認ください。Glamaのインストール、API Token、初回利用ガイドに従ってください。公開ディスカバリーと個人接続の成功は別々に確認してください。生成にはAceアカウントの残高が使用されます。

gooseでNano Bananaを使用する

独立したAce Data CloudのNano Bananaネイティブgooseプラグインを使用します：インストールとAPI Tokenのガイド · 簡体字中国語。このプラグインはこのMCPサーバーを再利用します。goose Marketplaceやデフォルトプロバイダーに含まれることを意味するものではありません。

公式MCP RegistryでNano Banana連携を見つける

公式MCP RegistryのNano Bananaを開き、一致するio.github.AceDataCloudのエントリーを展開して、MCPカタログに対応したクライアントでPackagesまたはRemotesのインストール情報を使用してください。これはAce Data Cloudが提供するNano Banana連携であり、モデルベンダーによる推奨を意味するものではありません。Registryはディレクトリであり、ツールを実行するアプリではありません。

mcp-nanobanana-pro（またはio.github.AceDataCloud/mcp-nanobanana-pro）を検索して、該当するエントリーを見つけてください。現在、公式Registryの検索で一致するのはサーバー名です。表示タイトルにスペースがあっても、検索エイリアスが追加されるわけではありません。クライアントがカタログに対応していない場合は、以下のクライアント固有の接続手順を使用し、トークン、サービスの権限、残高、現在の料金を確認するためにApplications → General applicationを確認してください。非同期の結果を確認するときは、元のタスクIDを保持してください。

機能

• 画像生成 - テキストプロンプトから高品質な画像を作成します
• 画像編集 - 既存の画像を変更したり、複数の画像を組み合わせたりします
• バーチャル試着 - 写真の人物に衣服を着せます
• 商品配置 - 商品をリアルなシーンに配置します
• タスク追跡 - 生成の進行状況を監視し、結果を取得します

ツールリファレンス

ツール	説明
nanobanana_generate_image	GoogleのNano Bananaモデルを使用し、テキストプロンプトからAI画像を生成します。
nanobanana_edit_image	テキストプロンプトに基づいて、AIで画像を編集または合成します。
nanobanana_get_task	画像生成または編集タスクのステータスと結果を照会します。
nanobanana_get_tasks_batch	複数の画像生成・編集タスクを一度に照会します。

接続：ホスト型 OAuth、API トークン、またはローカル stdio

ホスト型エンドポイントは https://nanobanana.mcp.acedata.cloud/mcp です。MCP クライアントには、次のいずれかの方法を選択してください。

方法	使用する場面	認証情報の設定
ホスト型 OAuth	クライアントがリモート MCP OAuth に対応している場合	URL だけを追加し、AceDataCloud にサインインしてアクセスを承認します。クライアント設定にトークンを貼り付ける必要はありません。
ホスト型 API トークン	クライアントで OAuth を完了できない場合、または明示的な連携用認証情報が必要な場合	Authorization: Bearer … ヘッダーで AceDataCloud API トークンを送信します。ローカルのシークレットストアまたは環境変数に保管してください。
ローカル stdio	クライアントがローカル MCP プロセスを実行する場合	mcp-nanobanana-pro をインストールし、そのプロセスに ACEDATACLOUD_API_TOKEN を渡します。この場合も AceDataCloud API が呼び出されます。

ホスト型サービスは、OAuth メタデータと動的クライアント登録（DCR）を公開しています。DCR はクライアントアプリケーションを登録するものであり、API キーではありません。 OAuth でサインインすると、クライアントは取得した Bearer トークンを送信します。アカウントの API 認証情報を再利用する場合も、新たに作成する場合もあります。ブラウザーからサインインするには、AceDataCloud アカウントが必要です。ホスト型サービスでは利用料金が発生する場合があります。実際に操作する前に、最新のサービスドキュメントと表示される料金を確認してください。同じサーバーに OAuth ログインと固定の Authorization ヘッダーを両方設定しないでください。

ホスト型 OAuth の例

• Claude および Claude Desktop のチャット： Customize → Connectors → Add custom connector でリモートのカスタムコネクターを追加し、https://nanobanana.mcp.acedata.cloud/mcp を入力してサインインを選択します。Claude から OAuth クライアントの登録方法を尋ねられた場合は、Register automatically を選択してください。同意手続きを完了します。Claude Desktop のローカル claude_desktop_config.json は別途設定が必要です。Claude コネクターガイド。
• Claude Code： claude mcp add --transport http --scope user nanobanana https://nanobanana.mcp.acedata.cloud/mcp を実行し、続いて claude mcp login nanobanana を実行します。/mcp で確認してください。Claude Code MCP ガイド。
• Cursor： https://nanobanana.mcp.acedata.cloud/mcp だけを指定してリモートサーバーを追加します。プロジェクトで使用する場合は、以下のエントリーを <project>/.cursor/mcp.json に統合します。個人用には ~/.cursor/mcp.json を使用してください。Cursor MCP ガイド。
• VS Code / Copilot： MCP: Add Server を実行し、HTTP を選択して https://nanobanana.mcp.acedata.cloud/mcp を入力し、ブラウザーでのサインインを完了します。新しいポータブルなワークスペース設定では <project>/.mcp.json を使用します。以下の VS Code 固有の形式では、<project>/.vscode/mcp.json またはユーザープロファイルを使用します。MCP: List Servers で確認してください。VS Code MCP の設定。
• Codex： codex mcp add nanobanana --url https://nanobanana.mcp.acedata.cloud/mcp を実行し、続いて codex mcp login nanobanana を実行します。ユーザー設定は ~/.codex/config.toml にあります。Codex 公式 MCP ガイド。

Cursor プロジェクト設定（OAuth）：

{
  "mcpServers": {
    "nanobanana": {"url": "https://nanobanana.mcp.acedata.cloud/mcp"}
  }
}

VS Code 固有のワークスペース設定（OAuth）：

{
  "servers": {
    "nanobanana": {"type": "http", "url": "https://nanobanana.mcp.acedata.cloud/mcp"}
  }
}

ホステッド API トークン

1. Ace Data Cloud → Applicationsを開きます。サインインするか、先にアカウントを登録します。
2. General applicationを見つけます。作成されていない場合は、Initialize General Applicationを選択します。汎用キーではアカウントで利用可能なサービスを使用できますが、専用アプリケーションのキーはそのサービスに限定されます。必要なサービス／モデルへのアクセスと現在の料金を確認します。
3. アプリケーションカードからAPI Keyをコピーするか、Keys / Manage Keys → Createを開いて、この連携用の個別のキーを作成します。後から個別に無効化またはローテーションできるよう、識別しやすい名前を付けます。
4. キーを作成するときは、Expiration Time、Set Usage Limitation、Allowed APIsを確認します。必要な制限のみ有効にし、呼び出す操作を許可してからCreateをクリックし、キーの一覧からトークンをコピーします。タスクの検索権限があっても、生成を送信する権限が付与されるわけではありません。最初のリクエストに必要な残高がアプリケーションにあることを確認します。トライアルの利用枠がある場合は、アカウントに現在表示されている内容が適用されます。
5. 引用符、空白、Bearer を含めず、トークン値のみをコピーします。API Key／API Token フィールドにはこの生の値を入力します。手動で設定する HTTP Authorizationヘッダーに限り、Bearer プレフィックスが必要です。platform-...形式のアカウント管理用トークンを、生成 API キーの代わりに使用することはできません。

キーは、クライアントの認証情報ストアか、以下に示す環境変数に保存します。プロンプト、共有ワークフロー、スクリーンショット、Git コミットには絶対に含めないでください。認証に失敗した場合は、別のキーを作成する前に、コピーした値全体、アプリケーション／サービスへのアクセス、期限、利用制限、残高を確認します。

固定の Bearer ヘッダーは OAuth をバイパスします。ヘッダーが無効な場合は、ブラウザーでのサインインを試す前に削除してください。保存した認証情報は非公開にしてください。

Claude Code では、サーバーを追加するときにシェルがトークンを展開します。保存されたユーザー MCP 設定は秘密情報として扱ってください。

export ACEDATACLOUD_API_TOKEN='YOUR_API_TOKEN'
claude mcp add --transport http --scope user nanobanana https://nanobanana.mcp.acedata.cloud/mcp \
  --header "Authorization: Bearer $ACEDATACLOUD_API_TOKEN"

Claude Code のプロジェクト設定では、<project>/.mcp.jsonに変数参照を記述し、その変数を Claude Code の起動環境で設定します。

{
  "mcpServers": {
    "nanobanana": {
      "type": "http",
      "url": "https://nanobanana.mcp.acedata.cloud/mcp",
      "headers": {"Authorization": "Bearer ${ACEDATACLOUD_API_TOKEN}"}
    }
  }
}

Cursor では、~/.cursor/mcp.jsonまたはコミットしないプロジェクト設定で、異なる環境変数の構文を使用します。

{
  "mcpServers": {
    "nanobanana": {
      "url": "https://nanobanana.mcp.acedata.cloud/mcp",
      "headers": {"Authorization": "Bearer ${env:ACEDATACLOUD_API_TOKEN}"}
    }
  }
}

VS Code では、MCP: Open User Configurationを実行し、このサーバーとマスク入力をマージします。${input:...}は VS Code のユーザー／ワークスペース形式用であり、Agent Host の.mcp.json形式では使用できません。

{
  "inputs": [
    {"id": "acedata-nanobanana-token", "type": "promptString", "description": "AceDataCloud API token", "password": true}
  ],
  "servers": {
    "nanobanana": {
      "type": "http",
      "url": "https://nanobanana.mcp.acedata.cloud/mcp",
      "headers": {"Authorization": "Bearer ${input:acedata-nanobanana-token}"}
    }
  }
}

Clineでは、MCP 設定 UI または CLI ファイル~/.cline/data/settings/cline_mcp_settings.jsonを使用します。リモートトランスポートの値はstreamableHttpです。JetBrains AI Assistantでは、**Settings → Tools → AI Assistant → Model Context Protocol (MCP)**からリモート URL を追加します。Zedでは、OAuth の場合は URL のみを指定したcontext_serversエントリーを使用するか、ローカルの Bearer ヘッダーを追加します。これらのクライアントは設定スキーマがそれぞれ異なるため、別のクライアントの JSON をコピーせず、最新の UI に従ってください。Cline · JetBrains · Zed.

ローカル stdio

パッケージをインストールし、ローカルプロセスに API トークンを渡します：

python -m pip install mcp-nanobanana-pro
export ACEDATACLOUD_API_TOKEN='YOUR_API_TOKEN'
mcp-nanobanana-pro

Claude Desktop のローカル MCP では、開発者設定から開くファイル（macOS では ~/Library/Application Support/Claude/claude_desktop_config.json）にこのエントリを統合します。uvx を使うには、uv が PATH に必要です：

{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {"ACEDATACLOUD_API_TOKEN": "YOUR_API_TOKEN"}
    }
  }
}

このユーザーレベルのファイルは非公開にしてください。セルフホストの HTTP は mcp-nanobanana-pro --transport http --port 8000 で使用できます。適切なネットワーク制御と TLS 制御がある場合にのみ公開してください。ローカルで実行しても、AceDataCloud API が呼び出されます。

サービスを使用する前の確認

1. https://nanobanana.mcp.acedata.cloud/health が {"status":"ok"} を返す場合、確認できるのはエンドポイントへの到達性のみです。
2. MCP クライアントがツールを読み込んでいることを確認します。ツール一覧で確認できるのは MCP の検出状況であり、下流 API へのアクセスや残高ではありません。
3. API を完全に確認する必要がある場合は、最新のサービスドキュメントと表示価格を確認してから、自分の有効な入力で nanobanana_generate_image を呼び出します。結果にタスク ID が含まれている場合は、終端状態の成功または失敗になるまで、同じ ID を指定して nanobanana_get_task を呼び出します。進捗を確認するためだけに操作を再送信しないでください。

401 が返された場合は、クライアントが使用した認証方式と、トークンまたは OAuth セッションが有効かどうかを確認してください。403 は、アカウント権限またはコンテンツモデレーションによる失敗を示している可能性があります。返されたエラーを確認してください。残高不足や下流サービスの障害は、それぞれ個別に診断する必要があります。ツールが一覧に表示されていることや、タスクが送信されたことは、結果の成功を示すものではありません。

利用可能なツール

画像生成

ツール	説明
nanobanana_generate_image	テキストプロンプトから画像を生成します
nanobanana_edit_image	AI で画像を編集または合成します

タスク

ツール	説明
nanobanana_get_task	単一タスクのステータスを照会します
nanobanana_get_tasks_batch	複数タスクを一度に照会します

対応モデル

モデル	解像度
nano-banana（デフォルト）	1K
nano-banana-2-lite	1K
nano-banana-2	1K、2K、4K
nano-banana-2.1	1K、2K、4K
nano-banana-pro	1K、2K、4K

5 つすべてのモデルが生成と編集に対応しています。既存の nano-banana、nano-banana-2-lite、nano-banana-2、nano-banana-pro モデルには、:official バリアントもあります。Nano Banana 2.1 には :official バリアントがありません。nano-banana-2.1 をそのまま使用してください。model を省略すると、nano-banana が選択されます。

使用例

Nano Banana 2.1 による生成と編集

nanobanana_generate_image に次の引数を渡します：

{
  "prompt": "A blue ceramic vase on a cream background, soft side lighting, no text",
  "model": "nano-banana-2.1",
  "aspect_ratio": "1:1",
  "resolution": "2K",
  "count": 2
}

nanobanana_edit_image では、参照画像の URL を指定します：

{
  "prompt": "Change the vase to green while preserving the background and lighting",
  "image_urls": ["https://example.com/vase.png"],
  "model": "nano-banana-2.1",
  "resolution": "4K"
}

生成と編集は非同期で送信されます。返された task_id を保持し、終端状態の成功または失敗になるまで nanobanana_get_task で照会してください。送信しただけでは画像の生成は完了していません。aspect_ratio を指定せずに編集すると、最初の参照画像のアスペクト比が維持されます。resolution を省略した場合、デフォルトは 1K です。使用する前に、最終的な画像とピクセル寸法を確認してください。

プロンプトから画像を生成

User: Create an image of a sunset over mountains

Claude: I'll generate that image for you.
[Calls nanobanana_generate_image with detailed prompt]

バーチャル試着

User: Put this shirt on this model
[Provides two image URLs]

Claude: I'll combine these images.
[Calls nanobanana_edit_image with both image URLs]

商品撮影

User: Place this product in a modern kitchen scene
[Provides product image URL]

Claude: I'll create a product scene for you.
[Calls nanobanana_edit_image with scene description]

プロンプト作成のヒント

最良の結果を得るには、プロンプトに次の要素を含めてください：

• 主な被写体：何を主な焦点にしますか？
• 雰囲気：画像でどのようなムードを表現しますか？
• 照明：シーンをどのように照らしますか？
• カメラ／レンズ：どのような写真のスタイルですか？（85mm のポートレート、広角など）
• 品質キーワード：技術的な描写（ボケ、フィルム粒子、HDR など）

プロンプトの例

A photorealistic close-up portrait of an elderly Japanese ceramicist
with deep wrinkles and a warm smile. Soft golden hour light streaming
through a window. Captured with an 85mm portrait lens, soft bokeh
background. Serene and masterful mood.

設定

環境変数

変数	説明	デフォルト
ACEDATACLOUD_API_TOKEN	AceDataCloud の API トークン	必須
ACEDATACLOUD_API_BASE_URL	API のベース URL	https://api.acedata.cloud
ACEDATACLOUD_OAUTH_CLIENT_ID	OAuth クライアント ID（ホストモード）	—
ACEDATACLOUD_PLATFORM_BASE_URL	プラットフォームのベース URL	https://platform.acedata.cloud
NANOBANANA_REQUEST_TIMEOUT	リクエストのタイムアウト（秒）	1800
LOG_LEVEL	ログレベル	INFO

コマンドラインオプション

mcp-nanobanana-pro --help

Options:
  --version          Show version
  --transport        Transport mode: stdio (default) or http
  --port             Port for HTTP transport (default: 8000)

開発

開発環境のセットアップ

# Clone repository
git clone https://github.com/AceDataCloud/NanoBananaMCP.git
cd NanoBananaMCP

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # or `.venv\Scripts\activate` on Windows

# Install with dev dependencies
pip install -e ".[dev,test]"

テストの実行

# Run unit tests
pytest

# Run with coverage
pytest --cov=core --cov=tools

# Run integration tests (requires API token)
pytest tests/test_integration.py -m integration

コード品質

# Format code
ruff format .

# Lint code
ruff check .

# Type check
mypy core tools

ビルドと公開

# Install build dependencies
pip install -e ".[release]"

# Build package
python -m build

# Upload to PyPI
twine upload dist/*

プロジェクト構成

NanoBanana/
├── core/                   # Core modules
│   ├── __init__.py
│   ├── client.py          # HTTP client for NanoBanana API
│   ├── config.py          # Configuration management
│   ├── exceptions.py      # Custom exceptions
│   ├── server.py          # MCP server initialization
│   ├── types.py           # Type definitions
│   └── utils.py           # Utility functions
├── tools/                  # MCP tool definitions
│   ├── __init__.py
│   ├── image_tools.py     # Image generation/editing tools
│   └── task_tools.py      # Task query tools
├── prompts/                # MCP prompt templates
│   └── __init__.py
├── tests/                  # Test suite
├── deploy/                 # Deployment configs
│   └── production/
│       ├── deployment.yaml
│       ├── ingress.yaml
│       └── service.yaml
├── .env.example           # Environment template
├── .gitignore
├── Dockerfile             # Docker image for HTTP mode
├── docker-compose.yaml    # Docker Compose config
├── LICENSE
├── main.py                # Entry point
├── pyproject.toml         # Project configuration
└── README.md

API リファレンス

このサーバーはAceDataCloud NanoBanana APIをラップしています。

• NanoBanana Images API - 画像の生成と編集
• NanoBanana Tasks API - タスクの照会

ユースケース

• ポートレートの補正 - 同じ人物にさまざまな服装を試します
• 商品シーンの合成 - 白背景の商品をリアルな環境に配置します
• 属性の置き換え - 素材、色、バリエーションを変更します
• ポスターのクイック編集 - スタイルやテーマをすばやく変更します
• 2D から 3D への変換 - 画像を 3D 商品モックアップに変換します
• 画像の修復 - 古い写真や破損した写真を修復します

コントリビューション

コントリビューションを歓迎します。以下の手順に従ってください。

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing）
3. 変更をコミットします（git commit -m 'Add amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing）
5. プルリクエストを作成します

ドキュメント

ドキュメント

ライセンス

MIT ライセンスです。詳細はLICENSEを参照してください。

リンク

• AceDataCloud プラットフォーム
• Model Context Protocol
• MCP Python SDK

---

AceDataCloudが心を込めて作成しました

Cline のセットアップ／Cline の図解ガイド

Nano Banana by Ace Data Cloud — 英語ガイド · 図解付きの詳しい手順. 2026-10-18 時点で、Cline マーケットプレイスへの申請は審査待ちです。このガイドでは手動での代替手順を別途説明しています。／Cline 公式ディレクトリへの申請は引き続き審査待ちです。手動での接続は掲載済みであることを意味しません。