Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1
Prepare the server locally
Run this once before adding it to Claude Code.
cd gemini-image-mcp
npm install2
Register it in Claude Code
claude mcp add -e "GEMINI_API_KEY=${GEMINI_API_KEY}" gemini-image-0c58 -- node /path/to/server.jsReplace any placeholder paths in the command with the real path on your machine.
Required:
GEMINI_API_KEY3
Make your agent remember this setup
gemini-image-0c58's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Text-to-image generation using Gemini API
- Multi-turn image editing sessions
- Support for various aspect ratios and image sizes
- Configurable image generation models
Tools 5
generate_imageGenerates an image from a text prompt.edit_imageEdits an existing image based on a prompt.start_image_sessionStarts a multi-turn image editing session.continue_image_sessionContinues an existing image editing session.get_image_config_infoRetrieves information about available configuration options.Environment Variables
GEMINI_API_KEYrequiredAPI key for accessing the Gemini serviceTry it
→Generate an image of a futuristic city and save it as city.png.
→Take city.png and add flying cars to the scene, saving it as city-v2.png.
→Start an image editing session to create a mountain landscape.
→In the current image session, add a lake to the mountain landscape.
Original README from jk7g14/gemini-image-mcp
gemini-image-mcp
Gemini API를 활용한 이미지 생성/편집 도구. MCP 서버와 JS 모듈 두 가지 방식으로 사용 가능.
설치
cd gemini-image-mcp
npm install
API 키 설정
cp .env.example .env
# .env 파일에 실제 API 키 입력
사용법 1: MCP 서버 (Claude Code)
claude mcp add --transport stdio gemini-image -- node server.js
등록 후 Claude Code에서 자연어로 사용:
- "고양이 이미지 하나 생성해서 cat.png로 저장해줘"
- "cat.png에서 배경을 우주로 바꿔서 cat-space.png로 저장해줘"
- "이미지 편집 세션 시작해서 산 풍경 그려줘" → "호수 추가해줘"
MCP 도구 목록
| 도구 | 설명 |
|---|---|
generate_image |
텍스트 → 이미지 생성 |
edit_image |
기존 이미지 + 프롬프트 → 편집 |
start_image_session |
멀티턴 편집 세션 시작 |
continue_image_session |
세션 이어서 편집 |
get_image_config_info |
설정 옵션 정보 확인 |
사용법 2: JS 모듈
import { generateImage, editImage, createSession } from './gemini-image.js';
// 이미지 생성
await generateImage('고양이', { output: './cat.png' });
// 이미지 편집
await editImage('./cat.png', '배경을 우주로', { output: './cat-space.png' });
// 멀티턴 세션
const session = createSession();
await session.send('산 풍경', { output: './v1.png' });
await session.send('호수 추가', { output: './v2.png' });
await session.sendWithImage('./photo.png', '스타일 변경', { output: './v3.png' });
설정 옵션
- aspectRatio:
"1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9","21:9" - imageSize:
"1K"(기본),"2K","4K" - model: 기본
gemini-3-pro-image-preview - 참고 문서: https://ai.google.dev/gemini-api/docs/image-generation?hl=ko