de en es ja ko ru zh

NanoBananaMCP

Name: NanoBananaMCP
Author: AceDataCloud

by AceDataCloud

Overview Schema Related Servers Score Discussions

Python

Remote

NanoBananaMCP

PyPI version PyPI downloads Python 3.10+ License: MIT MCP

AceDataCloud API를 통해 Google의 Nano Banana 모델을 사용하는 Model Context Protocol (MCP) 서버입니다.

Claude, VS Code 또는 모든 MCP 호환 클라이언트에서 직접 AI 이미지를 생성하고 편집하세요.

기능

이미지 생성 - 텍스트 프롬프트로 고품질 이미지 생성
이미지 편집 - 기존 이미지 수정 또는 여러 이미지 결합
가상 착용(Virtual Try-On) - 사진 속 인물에게 의류 착용
제품 배치 - 현실적인 장면에 제품 배치
작업 추적 - 생성 진행 상황 모니터링 및 결과 검색

Related MCP server: MidjourneyMCP

도구 참조

도구	설명
`nanobanana_generate_image`	Google의 Nano Banana 모델을 사용하여 텍스트 프롬프트로 AI 이미지 생성
`nanobanana_edit_image`	텍스트 프롬프트를 기반으로 AI를 사용하여 이미지 편집 또는 결합
`nanobanana_get_task`	이미지 생성 또는 편집 작업의 상태 및 결과 조회
`nanobanana_get_tasks_batch`	여러 이미지 생성/편집 작업을 한 번에 조회

빠른 시작

1. API 토큰 받기

AceDataCloud 플랫폼에 가입
API 문서 페이지로 이동
**"Acquire"**를 클릭하여 API 토큰 획득
아래 사용을 위해 토큰 복사

2. 호스팅된 서버 사용 (권장)

AceDataCloud는 관리형 MCP 서버를 호스팅하므로 로컬 설치가 필요하지 않습니다.

엔드포인트: https://nanobanana.mcp.acedata.cloud/mcp

모든 요청에는 Bearer 토큰이 필요합니다. 1단계에서 받은 API 토큰을 사용하세요.

Claude.ai

OAuth를 사용하여 Claude.ai에 직접 연결하세요. API 토큰이 필요하지 않습니다:

Claude.ai 설정 → 통합 → 더 추가하기로 이동
서버 URL 입력: https://nanobanana.mcp.acedata.cloud/mcp
OAuth 로그인 흐름 완료
대화에서 도구 사용 시작

Claude Desktop

설정 파일(~/Library/Application Support/Claude/claude_desktop_config.json, macOS 기준)에 추가:

{
  "mcpServers": {
    "nanobanana": {
      "type": "streamable-http",
      "url": "https://nanobanana.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Cursor / Windsurf

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 (Copilot)

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 서버를 클릭 한 번으로 설정할 수 있습니다.

JetBrains IDEs

**설정 → 도구 → AI Assistant → Model Context Protocol (MCP)**로 이동
추가 → HTTP 클릭
붙여넣기:

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

Claude Code

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

Cline의 MCP 설정(.cline/mcp_settings.json)에 추가:

{
  "mcpServers": {
    "nanobanana": {
      "type": "streamable-http",
      "url": "https://nanobanana.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Amazon Q Developer

MCP 구성에 추가:

{
  "mcpServers": {
    "nanobanana": {
      "type": "streamable-http",
      "url": "https://nanobanana.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Roo Code

Roo Code MCP 설정에 추가:

{
  "mcpServers": {
    "nanobanana": {
      "type": "streamable-http",
      "url": "https://nanobanana.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Continue.dev

.continue/config.yaml에 추가:

mcpServers:
  - name: nanobanana
    type: streamable-http
    url: https://nanobanana.mcp.acedata.cloud/mcp
    headers:
      Authorization: "Bearer YOUR_API_TOKEN"

Zed

Zed 설정(~/.config/zed/settings.json)에 추가:

{
  "language_models": {
    "mcp_servers": {
      "nanobanana": {
        "url": "https://nanobanana.mcp.acedata.cloud/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_TOKEN"
        }
      }
    }
  }
}

cURL 테스트

# 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"}}}'

3. 또는 로컬에서 실행 (대안)

자신의 컴퓨터에서 서버를 실행하려면:

# 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

Claude Desktop (로컬)

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

Docker (셀프 호스팅)

docker pull ghcr.io/acedatacloud/mcp-nanobanana-pro:latest
docker run -p 8000:8000 ghcr.io/acedatacloud/mcp-nanobanana-pro:latest

클라이언트는 자체 Bearer 토큰으로 연결하며, 서버는 각 요청의 Authorization 헤더에서 토큰을 추출합니다.

사용 가능한 도구

이미지 생성

도구	설명
`nanobanana_generate_image`	텍스트 프롬프트로 이미지 생성
`nanobanana_edit_image`	AI로 이미지 편집 또는 결합

작업

도구	설명
`nanobanana_get_task`	단일 작업 상태 조회
`nanobanana_get_tasks_batch`	여러 작업 한 번에 조회

사용 예시

프롬프트로 이미지 생성

User: Create an image of a sunset over mountains

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

가상 착용(Virtual Try-On)

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 이미지 API - 이미지 생성 및 편집
NanoBanana 작업 API - 작업 쿼리

사용 사례

인물 사진 보정 - 동일한 인물에게 다른 의류 착용 시도
제품 장면 구성 - 흰색 배경의 제품을 현실적인 환경에 배치
속성 교체 - 재질, 색상 또는 변형 변경
포스터 빠른 편집 - 스타일이나 테마를 빠르게 변경
2D에서 3D로 변환 - 이미지를 3D 제품 목업으로 변환
이미지 복원 - 오래되거나 손상된 사진 복원

기여

기여를 환영합니다! 다음 단계를 따라주세요:

저장소 포크
기능 브랜치 생성 (git checkout -b feature/amazing)
변경 사항 커밋 (git commit -m 'Add amazing feature')
브랜치로 푸시 (git push origin feature/amazing)
Pull Request 열기

라이선스

MIT 라이선스 - 자세한 내용은 LICENSE를 참조하세요.

링크

AceDataCloud에서 사랑을 담아 제작함

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

2dRelease cycle

80Releases (12mo)

Commit activity

Issues opened vs closed

Resources

Need Help?

Reddit Discussion

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

Nanana AI Image Generation
Image & Video Processing Multimedia Processing App Automation
nanana-app
A
license
A
quality
F
maintenance
Enables AI assistants to generate images from text prompts and transform existing images using Google Gemini's nano banana model through the Nanana AI service. Supports both text-to-image generation and image-to-image transformation capabilities.
Updated a year ago (2025-10-12 02:16 UTC)
2
16
10
MIT
MidjourneyMCP
Image & Video Processing Multimedia Processing
AceDataCloud
A
license
A
quality
B
maintenance
Enables AI image and video generation using Midjourney through the AceDataCloud API. It supports comprehensive features including image creation, transformation, blending, editing, and video generation directly within MCP-compatible clients.
Updated 9 days ago (2026-08-18 15:35 UTC)
16
7
MIT
Gemini Image MCP
Image & Video Processing Multimedia Processing Autonomous Agents
jk7g14
F
license
B
quality
D
maintenance
Enables image generation and multi-turn editing sessions using the Gemini API within MCP-compatible environments. Users can create, modify, and configure images through natural language commands, supporting features like aspect ratio adjustments and session-based image transformations.
Updated 7 months ago (2026-02-09 01:53 UTC)
5
MCP Banana Image
Image & Video Processing AI & Machine Learning Multimedia Processing
Trigi-Digital
A
license
Not graded
quality
C
maintenance
AI-powered image generation MCP server with 16 specialized tools for generating, editing, analyzing, and processing images using Google's Nano Banana 2 model. Supports custom API endpoints and integrates with AI coding assistants via natural language.
Updated 6 months ago (2026-03-01 02:55 UTC)
166
1
MIT

View all related MCP servers

Related MCP Connectors

openFlow
Omni Flash and Veo video, Nano Banana images on Google Flow, from any MCP client
BananaBanana Image, Video & Speech Generation
Generate images, video & speech with Nano Banana, Veo, Omni and Gemini TTS. Pay as you go.
mcp-veo
MCP server for Google Veo AI video generation

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

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

NanoBananaMCP

기능

도구 참조

빠른 시작

1. API 토큰 받기

2. 호스팅된 서버 사용 (권장)

Claude.ai

Claude Desktop

Cursor / Windsurf

VS Code (Copilot)

JetBrains IDEs

Claude Code

Cline

Amazon Q Developer

Roo Code

Continue.dev

Zed

cURL 테스트

3. 또는 로컬에서 실행 (대안)

Claude Desktop (로컬)

Docker (셀프 호스팅)

사용 가능한 도구

이미지 생성

작업

사용 예시

프롬프트로 이미지 생성

가상 착용(Virtual Try-On)

제품 사진 촬영

프롬프트 작성 팁

프롬프트 예시

구성

환경 변수

명령줄 옵션

개발

개발 환경 설정

테스트 실행

코드 품질

빌드 및 배포

프로젝트 구조

API 참조

사용 사례

기여

라이선스

링크

Maintenance

Resources

Looking for Admin?

Tools

Related MCP Servers

Nanana AI Image Generation

MidjourneyMCP

Gemini Image MCP

MCP Banana Image

Related MCP Connectors

Latest Blog Posts

MCP directory API