YCSE/nanobanana-mcp
Claude Desktop·Code·Cursor에서 Google Gemini 이미지 생성·편집을 사용할 수 있는 MCP 서버
29+0이번 주0 찜
5포크0이슈
중간맛 분석
JavaScript 기반 MCP 서버로, Claude Desktop·Claude Code·Cursor와 통합되어 Google Gemini의 이미지 생성·편집 를 활용합니다. 난이도는 중상(설정 후 즉시 사용 가능하나 키 관리·config 편집 필요). Flash 모델로 빠른 반복, Pro 모델로 최종 품질 확보가 가능하며, 세션 기반 이미지 히스토리로 캐릭터 일관성을 유지할 수 있습니다. 설치 후 즉시 Claude 내에서 '/nb-flash', '/nb-pro' 슬래시 명령어로 모델 전환 가능.
이런 레포예요
이럴 때 쓰면 좋아요
- Claude 내에서 텍스트 프롬프트로 2K 이미지를 실시간 생성하며 디자인 아이디어 빠르게 시각화하기
- 같은 conversation_id로 일관된 캐릭터·스타일을 유지하며 여러 장의 일러스트 시리즈 제작하기
- Flash 모델로 초안 생성 후 Pro 모델로 최종 품질 향상하여 반복 개선 프로세스 자동화하기
핵심 기능
Gemini Flash·Pro 멀티모달 이미지 생성·편집세션 기반 이미지 히스토리로 캐릭터 일관성 유지Claude·Code·Cursor 통합 및 슬래시 명령어 모델 전환
대안 대비 차별점
Google Gemini API 무료 티어를 활용하면서 기존 Claude 워크플로우 내에서 자연스럽게 이미지 생성·편집을 수행할 수 있으며, MCP 프로토콜 표준으로 여러 AI IDE에 동일하게 적용 가능합니다.
준비물
- Node.js 18 이상
- Google AI API 키
바로 시작하기
- Node.js 18 이상과 Google AI API 키 준비
# https://makersuite.google.com/app/apikey에서 API 키 발급
- Claude Code에 추가
claude mcp add nanobanana-mcp -- npx -y @ycse/nanobanana-mcp -e "GOOGLE_AI_API_KEY=your_api_key"
- Claude Desktop에 추가:
~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는%APPDATA%\Claude\claude_desktop_config.json(Windows) 편집
{
"mcpServers": {
"nanobanana-mcp": {
"command": "npx",
"args": ["-y", "@ycse/nanobanana-mcp"],
"env": {
"GOOGLE_AI_API_KEY": "your_api_key"
}
}
}
}
- Cursor에 추가:
.cursor/mcp.json(프로젝트) 또는~/.cursor/mcp.json(전역) 생성/편집
{
"mcpServers": {
"nanobanana-mcp": {
"command": "npx",
"args": ["-y", "@ycse/nanobanana-mcp"],
"env": {
"GOOGLE_AI_API_KEY": "your_api_key"
}
}
}
}
- Claude 클라이언트 재시작 후 사용 시작
별 추이 · 7일
29+0 / 7일
활용성 · 따라 만들기 좋은가
샘플 점수 20/100
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
⚪ 최근 활동 정보 없음 · 2025년 생성
이 레포에 깃밥 배지 달기
[](https://www.gitbap.com/r/YCSE/nanobanana-mcp)🔌 클로드에서 바로 써보기
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
방법 ① 커넥터 URL
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp방법 ② 플러그인 (체험까지)
플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기