/ 디렉터리 / 플레이그라운드 / MCP Image
● 커뮤니티 shinpr 🔑 본인 키 필요

MCP Image

제작: shinpr · shinpr/mcp-image

Gemini(Nano Banana 2/Pro)를 통해 이미지 생성 및 편집 — 자동 프롬프트 최적화, 4K 출력, 자연어 편집, 문자 일관성.

mcp-image는 단일 generate_image 도구 뒤에 Google의 Gemini 이미지 모델(Nano Banana 2 / Nano Banana Pro)을 래핑합니다. 간단한 프롬프트를 제공하세요. 서버는 모델을 호출하기 전에 Subject-Context-Style 프레임워크로 이를 강화하고, 품질 계층(빠름/균형/품질)을 선택하고, 자연어를 통해 이미지 편집을 지원하고, 세대 전반에 걸쳐 문자 일관성을 유지합니다. 최대 4K 출력, 화면비 1:1~21:9. 무료 Gemini API 키가 필요합니다.

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

mcp-image.replay ▶ 준비됨
0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcp-image",
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "mcp-image": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-image"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add mcp-image -- npx -y mcp-image

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: MCP Image

랜딩 페이지의 히어로 이미지 생성 후 반복

👤 디자이너, 창립자, 마케팅 담당자 ⏱ ~15 min beginner

언제 쓸까: 당신은 신선한 영웅 이미지를 원하고 5개의 탭을 저글링하고 싶지 않습니다.

사전 조건
  • 제미니 API 키 — https://aistudio.google.com/apikey
  • 출력 디렉터리 — mkdir -p ~/이미지/mcp
흐름
  1. v1 생성
    히어로 이미지 생성: 최소 작업 공간, 따뜻한 황금시간대 조명, 16:9, 품질 등급, 2048px.✓ 복사됨
    → 강화된 프롬프트가 다시 에코되어 IMAGE_OUTPUT_DIR에 저장된 이미지
  2. 제자리에서 편집
    편집하세요. 수평선에 얇은 나무 선을 추가하고 나머지는 그대로 유지하세요.✓ 복사됨
    → 변형이 저장되었습니다. 보존된 구성
  3. 변형을 사용해 보세요
    같은 장면이지만 더 시원한 톤으로 피사체를 동일하게 유지하세요.✓ 복사됨
    → 캐릭터 일관성이 유지됩니다. 색이 바뀜

결과: Midjourney를 통한 유료 좌석 왕복이 아닌 몇 분 만에 배송 가능한 영웅 이미지입니다.

함정
  • 최적화 프로그램에 과도한 프롬프트 표시 — Subject-Context-Style 강화 프로그램이 해당 작업을 수행하도록 합니다. 5줄의 형용사로 재정의하지 마세요.
함께 쓰기: filesystem

브랜드와 일치하는 일러스트레이션 세트 제작

👤 브랜드 자산 라이브러리가 없는 솔로 창업자 및 디자이너 ⏱ ~45 min intermediate

언제 쓸까: 함께 속해 있는 것처럼 보이는 6~12개의 일러스트레이션이 필요합니다.

흐름
  1. 스타일시트 정의
    스타일 참조 생성: 평면 일러스트레이션, 부드러운 파스텔 팔레트, 2자 비네트.✓ 복사됨
    → 스타일을 포착하는 씨앗 이미지
  2. 변형 만들기
    해당 스타일을 사용하여 온보딩, 청구, 팀, 통합, 보안, 분석 섹션에 대한 6가지 일러스트레이션을 만듭니다.✓ 복사됨
    → 일관된 스타일과 캐릭터를 갖춘 6개의 이미지

결과: 하루동안 일러스트레이터를 고용하지 않고도 응집력 있는 일러스트 세트입니다.

함정
  • 이미지 간 드리프트 — 항상 시드 이미지를 참조하고 '시드에서 스타일 유지'를 사용하세요.

자연어로 제품 사진 편집

👤 전자상거래 사업자, 소규모 브랜드 ⏱ ~20 min beginner

언제 쓸까: 원본 제품 사진이 있고 Photoshop 없이 멋진 효과를 원합니다.

흐름
  1. 사진 업로드/참조
    product.jpg를 기본으로 사용합니다. 어수선한 배경을 제거하세요. 그림자를 유지하다; 스튜디오 조명.✓ 복사됨
    → 자연스러운 그림자로 깔끔한 제품샷
  2. 컨텍스트 추가
    같은 제품을 따뜻한 대리석 표면에 위에서 아래로 올려놓은 모습입니다.✓ 복사됨
    → 새로운 환경에도 일관된 제품

결과: 단 몇 분 만에 카탈로그에 준비된 이미지를 얻을 수 있습니다.

함께 쓰기: filesystem

조합

다른 MCP와 조합해 10배 효율

mcp-image + filesystem

이미지 라이브러리 생성, 나열, 태그 지정 및 구성

오늘의 세트를 ~/images/mcp/2026-04-21/에 생성합니다. 그런 다음 대체 텍스트로 나열하고 이름을 바꿉니다.✓ 복사됨
mcp-image + magic-ui-mcp

생성된 히어로 이미지를 Magic UI 랜딩에 드롭

히어로 이미지를 생성한 다음 이를 Magic UI 히어로 구성 요소에 연결합니다.✓ 복사됨
mcp-image + comfyui-mcp-server

일회성 생성에는 mcp-image를 사용하십시오. 파이프라인을 위한 ComfyUI

mcp-image를 통한 빠른 변형; ComfyUI를 통한 제작 워크플로우.✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
generate_image prompt: str, tier?: fast|balanced|quality, aspect?: '1:1'|'16:9'|..., base_image?: path, size?: '1K'|'2K'|'4K' 새로운 이미지를 생성하거나 자연어로 기존 이미지를 편집하세요. 1 Gemini image call

비용 및 제한

운영 비용

API 쿼터
Gemini API 계획의 이미지 생성 할당량에 따라 제한됨
호출당 토큰
텍스트에는 무시할 수 있습니다. 이미지 바이트가 지배적
금액
Gemini API를 통한 이미지당 지불; 개발에 사용 가능한 무료 계층
반복에는 tier=fast를 사용하고 최종 키퍼에는 tier=quality만 사용하세요.

보안

권한, 시크릿, 파급범위

자격 증명 저장: 환경에서만 GEMINI_API_KEY — 커밋하지 마세요. 유출된 경우 Google AI Studio에서 회전하세요.
데이터 외부 송신: 프롬프트와 선택적인 기본 이미지는 Google의 Gemini API로 이동됩니다. 생성된 바이트가 반환되어 로컬에 저장됩니다.

문제 해결

자주 발생하는 오류와 해결

401 / API 키가 잘못되었습니다.

GEMINI_API_KEY가 AI Studio의 원시 API 키(OAuth 토큰 아님)이고 이미지 생성이 활성화되어 있는지 확인하세요.

확인: curl https://generativelanguage.googleapis.com/v1beta/models?key=$GEMINI_API_KEY
출력이 저장되었지만 비어 있음

IMAGE_OUTPUT_DIR은 쓸 수 없거나 누락되었을 수 있습니다. 만들고 다시 시도하세요.

확인: touch $IMAGE_OUTPUT_DIR/.probe && rm $IMAGE_OUTPUT_DIR/.probe
세대 간 성격 표류

항상 동일한 base_image를 전달하고 프롬프트에 '주제를 동일하게 유지'를 포함하세요.

확인: Diff two generations visually

대안

MCP Image 다른 것과 비교

대안언제 쓰나단점/장점
everart스타일 훈련을 받은 Everart 모델이 있습니다.다양한 제공업체, 다양한 스타일 적용 범위
comfyui-mcp-server맞춤형 SD/FLUX 워크플로와 전체 파이프라인 제어가 필요합니다.훨씬 더 무거운 설정
higgsfield-ai-prompt-skill다른 제공업체에 대한 즉각적인 엔지니어링 지원을 원합니다.프롬프트만 표시 - 추론 없음

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기