Nano Banana MCP 接続ガイド

MCP（Model Context Protocol）は、Anthropic によって提唱されたモデルコンテキストプロトコルで、AI モデル（Claude、GPT など）が標準化されたインターフェースを通じて外部ツールを呼び出すことを可能にします。XHuoAPI が提供する Nano Banana MCP Server を使用することで、Claude Desktop、VS Code、Cursor などの AI クライアントで直接 AI 画像を生成および編集できます。

機能概要

Nano Banana MCP Server は以下のコア機能を提供します：

画像生成 — テキストプロンプトを通じて高品質な画像を生成
画像編集 — 既存の画像を修正したり、複数の画像を組み合わせたり
バーチャル試着 — 服を人物の写真に着せる
製品埋め込み — 製品を実際のシーンに配置
複数モデルサポート — nano-banana、nano-banana-2、nano-banana-pro モデルをサポート
タスククエリ — 生成進捗を監視し、結果を取得

前提準備

使用する前に、XHuoAPI API トークンを取得する必要があります：

XHuoAPI プラットフォームに登録またはログイン
Nano Banana Images API ページに移動
「Acquire」をクリックして API トークンを取得（初回申請で無料枠をプレゼント）

インストール設定

方法一：pip インストール（推奨）

pip install mcp-nanobanana-pro

方法二：ソースコードインストール

git clone https://github.com/XHuoAPI/NanoBananaMCP.git
cd NanoBananaMCP
pip install -e .

インストールが完了したら、mcp-nanobanana-pro コマンドでサービスを起動できます。

Claude Desktop での使用

Claude Desktop の設定ファイルを編集します：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

以下の設定を追加します：

{
  "mcpServers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "XHuoAPI_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}

uvx を使用する場合（事前にパッケージをインストールする必要はありません）：

{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "XHuoAPI_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}

設定を保存した後、Claude Desktop を再起動すると、対話の中で Nano Banana 関連ツールを使用できるようになります。

VS Code / Cursor での使用

プロジェクトのルートディレクトリに .vscode/mcp.json を作成します：

{
  "servers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "XHuoAPI_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}

または uvx を使用する場合：

{
  "servers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "XHuoAPI_API_TOKEN": "あなたのAPIトークン"
      }
    }
  }
}

利用可能なツール一覧

ツール名	説明
`nanobanana_generate_image`	テキストプロンプトを通じて画像を生成
`nanobanana_edit_image`	既存の画像を編集または組み合わせ
`nanobanana_get_task`	単一タスクの状態をクエリ
`nanobanana_get_tasks_batch`	バッチでタスクの状態をクエリ

使用例

設定が完了したら、AI クライアントで自然言語を使ってこれらの機能を直接呼び出すことができます。例えば：

「水彩画スタイルの山水画を生成して」
「この服をこの人に PS して」
「この製品をカフェのシーンに置いて」
「nano-banana-pro モデルを使って高品質なポートレートを生成して」

さらなる情報

GitHub リポジトリ：XHuoAPI/NanoBananaMCP
PyPI パッケージ：mcp-nanobanana-pro
API ドキュメント：Nano Banana API

Documentation Index

​機能概要

​前提準備

​インストール設定

​方法一：pip インストール（推奨）

​方法二：ソースコードインストール

​Claude Desktop での使用

​VS Code / Cursor での使用

​利用可能なツール一覧

​使用例

​さらなる情報