AceDataCloud APIを通じてGoogleのNano Bananaモデルを使用したAI画像生成および編集のためのModel Context Protocol (MCP)サーバーです。
Claude、VS Code、またはMCP互換クライアントから直接AI画像を生成・編集できます。
画像生成 - テキストプロンプトから高品質な画像を生成
画像編集 - 既存の画像の修正や複数の画像の結合
バーチャル試着 - 写真内の人物に衣服を着用させる
プロダクトプレースメント - 現実的なシーンに製品を配置する
タスク追跡 - 生成の進捗状況の監視と結果の取得
Related MCP server: MidjourneyMCP
ツール | 説明 |
| GoogleのNano Bananaモデルを使用して、テキストプロンプトからAI画像を生成します。 |
| テキストプロンプトに基づいて、AIを使用して画像を編集または結合します。 |
| 画像生成または編集タスクのステータスと結果を照会します。 |
| 複数の画像生成/編集タスクを一度に照会します。 |
AceDataCloudプラットフォームにサインアップします
APIドキュメントページに移動します
**「Acquire」**をクリックしてAPIトークンを取得します
以下の使用のためにトークンをコピーします
AceDataCloudは管理されたMCPサーバーをホストしており、ローカルインストールは不要です。
エンドポイント: https://nanobanana.mcp.acedata.cloud/mcp
すべてのリクエストにはBearerトークンが必要です。ステップ1で取得したAPIトークンを使用してください。
OAuthを使用してClaude.aiに直接接続します。APIトークンは不要です：
Claude.aiの設定 → 統合 → 追加に移動します
サーバーURLを入力します: https://nanobanana.mcp.acedata.cloud/mcp
OAuthログインフローを完了します
会話内でツールの使用を開始します
設定ファイル（macOSの場合は ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します：
{
"mcpServers": {
"nanobanana": {
"type": "streamable-http",
"url": "https://nanobanana.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}MCP設定（.cursor/mcp.json または .windsurf/mcp.json）に追加します：
{
"mcpServers": {
"nanobanana": {
"type": "streamable-http",
"url": "https://nanobanana.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}VS CodeのMCP設定（.vscode/mcp.json）に追加します：
{
"servers": {
"nanobanana": {
"type": "streamable-http",
"url": "https://nanobanana.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}または、VS Code用のAce Data Cloud MCP拡張機能をインストールしてください。これには15個のMCPサーバーがすべてバンドルされており、ワンクリックでセットアップできます。
**設定 → ツール → AI Assistant → Model Context Protocol (MCP)**に移動します
追加 → HTTPをクリックします
以下を貼り付けます：
{
"mcpServers": {
"nanobanana": {
"url": "https://nanobanana.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}Claude CodeはMCPサーバーをネイティブでサポートしています：
claude mcp add nanobanana --transport http https://nanobanana.mcp.acedata.cloud/mcp \
-h "Authorization: Bearer YOUR_API_TOKEN"または、プロジェクトの.mcp.jsonに追加します：
{
"mcpServers": {
"nanobanana": {
"type": "streamable-http",
"url": "https://nanobanana.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}ClineのMCP設定（.cline/mcp_settings.json）に追加します：
{
"mcpServers": {
"nanobanana": {
"type": "streamable-http",
"url": "https://nanobanana.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}MCP設定に追加します：
{
"mcpServers": {
"nanobanana": {
"type": "streamable-http",
"url": "https://nanobanana.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}Roo CodeのMCP設定に追加します：
{
"mcpServers": {
"nanobanana": {
"type": "streamable-http",
"url": "https://nanobanana.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}.continue/config.yamlに追加します：
mcpServers:
- name: nanobanana
type: streamable-http
url: https://nanobanana.mcp.acedata.cloud/mcp
headers:
Authorization: "Bearer YOUR_API_TOKEN"Zedの設定（~/.config/zed/settings.json）に追加します：
{
"language_models": {
"mcp_servers": {
"nanobanana": {
"url": "https://nanobanana.mcp.acedata.cloud/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
}# Health check (no auth required)
curl https://nanobanana.mcp.acedata.cloud/health
# MCP initialize
curl -X POST https://nanobanana.mcp.acedata.cloud/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'自身のマシンでサーバーを実行したい場合：
# Install from PyPI
pip install mcp-nanobanana-pro
# or
uvx mcp-nanobanana-pro
# Set your API token
export ACEDATACLOUD_API_TOKEN="your_token_here"
# Run (stdio mode for Claude Desktop / local clients)
mcp-nanobanana-pro
# Run (HTTP mode for remote access)
mcp-nanobanana-pro --transport http --port 8000{
"mcpServers": {
"nanobanana": {
"command": "uvx",
"args": ["mcp-nanobanana-pro"],
"env": {
"ACEDATACLOUD_API_TOKEN": "your_token_here"
}
}
}
}docker pull ghcr.io/acedatacloud/mcp-nanobanana-pro:latest
docker run -p 8000:8000 ghcr.io/acedatacloud/mcp-nanobanana-pro:latestクライアントは独自のBearerトークンで接続します。サーバーは各リクエストのAuthorizationヘッダーからトークンを抽出します。
ツール | 説明 |
| テキストプロンプトから画像を生成 |
| AIを使用して画像を編集または結合 |
ツール | 説明 |
| 単一のタスクステータスを照会 |
| 複数のタスクを一度に照会 |
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トークン | 必須 |
| APIベースURL |
|
| OAuthクライアントID（ホストモード） | — |
| プラットフォームベースURL |
|
| リクエストタイムアウト（秒） |
|
| ログレベル |
|
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このサーバーはAceDataCloud NanoBanana APIをラップしています：
NanoBanana Images API - 画像生成および編集
NanoBanana Tasks API - タスク照会
ポートレートの強化 - 同じ人物に異なる衣服を試着させる
製品シーンの構成 - 白背景の製品を現実的な環境に配置する
属性の置換 - 素材、色、バリエーションを変更する
ポスターのクイック編集 - スタイルやテーマを素早く変更する
2Dから3Dへの変換 - 画像を3D製品モックアップに変換する
画像修復 - 古い写真や損傷した写真を修復する
貢献を歓迎します！以下の手順に従ってください：
リポジトリをフォークする
フィーチャーブランチを作成する (git checkout -b feature/amazing)
変更をコミットする (git commit -m 'Add amazing feature')
ブランチにプッシュする (git push origin feature/amazing)
プルリクエストを開く
MITライセンス - 詳細はLICENSEを参照してください。
Made with love by AceDataCloud
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Omni Flash and Veo video, Nano Banana images on Google Flow, from any MCP client
Generate images, video & speech with Nano Banana, Veo, Omni and Gemini TTS. Pay as you go.
MCP server for Google Veo AI video generation
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/AceDataCloud/NanoBananaMCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server