Provides tools for image generation and editing through the Google Gemini API, enabling capabilities such as text-to-image creation, prompt-based image editing, and multi-turn image manipulation sessions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Gemini Image MCP Generate a 16:9 cyberpunk city landscape and save it as city.png"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Gemini API를 활용한 이미지 생성/편집 도구. MCP 서버와 JS 모듈 두 가지 방식으로 사용 가능.
cd gemini-image-mcp
npm installRelated MCP server: mcp-image
cp .env.example .env
# .env 파일에 실제 API 키 입력claude mcp add --transport stdio gemini-image -- node server.js등록 후 Claude Code에서 자연어로 사용:
"고양이 이미지 하나 생성해서 cat.png로 저장해줘"
"cat.png에서 배경을 우주로 바꿔서 cat-space.png로 저장해줘"
"이미지 편집 세션 시작해서 산 풍경 그려줘" → "호수 추가해줘"
도구 | 설명 |
| 텍스트 → 이미지 생성 |
| 기존 이미지 + 프롬프트 → 편집 |
| 멀티턴 편집 세션 시작 |
| 세션 이어서 편집 |
| 설정 옵션 정보 확인 |
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
기존 멀티턴 세션을 이어서 이미지를 편집합니다. 이전 대화 맥락이 유지됩니다.
Inputs: sessionId (required), prompt (required), outputPath (required), imagePath.
기존 이미지를 프롬프트에 따라 편집합니다
Inputs: imagePath (required), prompt (required), outputPath (required), aspectRatio, +2 more.
텍스트 프롬프트로 이미지를 생성합니다
Inputs: prompt (required), outputPath (required), aspectRatio, imageSize, +1 more.
이미지 생성/편집에 사용 가능한 설정 옵션 정보를 반환합니다
Inputs: no named parameters.
멀티턴 이미지 편집 세션을 시작합니다. 이전 맥락을 유지하며 반복 수정이 가능합니다.
Inputs: prompt (required), outputPath (required), imagePath, aspectRatio, +2 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 5 tools
The tools are mostly distinct in purpose, with clear separation between image generation, editing, and configuration. However, 'edit_image' and the session tools ('start_image_session', 'continue_image_session') could cause some confusion, as both involve editing images, though the session tools explicitly handle multi-turn contexts.
All tool names follow a consistent verb_noun pattern (e.g., generate_image, edit_image, get_image_config_info). The naming is predictable and readable throughout, with no deviations in style or convention.
With 5 tools, the server is well-scoped for image generation and editing tasks. Each tool has a clear role, and the count is appropriate for covering core operations without being overly sparse or bloated.
The tool set covers key operations like generation, editing, and configuration, with added support for multi-turn sessions. A minor gap is the lack of a tool for deleting or managing images, but this is not critical for the core functionality, and agents can likely work around it.
Generate AI images, video, music, and sound effects, and upscale them, from any MCP client.
Generate AI images and videos from any compatible MCP client.
Generate AI video, images and audio, and browse your history, from any MCP client.
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
