본문으로 건너뛰기

[MCP 사용법] image2svg-mcp — PNG·JPG 이미지를 확대해도 깨지지 않는 SVG로 바꾸기

· 바이브코드 운영팀

목차

AI가 만들어 준 로고를 크게 늘렸더니 가장자리가 뭉개진 적 있나요? image2svg-mcp를 연결하면 AI가 래스터 이미지(PNG, JPG, WEBP)를 확대해도 깨지지 않는 SVG 벡터로 바로 바꿔 줘요. API 키가 필요 없고 내 컴퓨터에서 돌아가요.

image2svg-mcp 로고: 픽셀 조각이 매끈한 벡터 곡선으로 바뀌는 모양 출처: botmonster/image2svg-mcp 저장소의 로고

이럴 때 쓰세요

  • AI로 만든 로고나 아이콘을 벡터 파일로 받고 싶을 때
  • 손으로 그린 스케치를 선명한 선화로 바꾸고 싶을 때
  • 사진을 색 수를 줄인 포스터 느낌의 일러스트로 바꾸고 싶을 때

이 서버가 주는 도구는 convert_image_to_svg 하나예요. 이미지를 base64 데이터나 주소(URL)로 넘기면 SVG 문서를 글자로 돌려줘요. 변환 정도를 정하는 옵션이 여러 개 있어서 AI에게 말로 지시할 수 있어요.

준비물

Python 패키지 실행 도구 uv(uvx 포함)가 필요해요. uvx가 없다면 먼저 설치하세요. 키나 토큰, 환경 변수는 필요 없어요.

pip install uv

설치

Claude Code에는 명령 한 줄로 등록해요. 처음 실행할 때 uvx가 패키지를 알아서 내려받아요.

claude mcp add image2svg --scope user -- uvx image2svg-mcp

내 컴퓨터의 이미지 파일을 file:// 주소로 읽게 하려면 폴더를 지정해서 등록해요. 지정한 폴더와 그 하위 폴더 안의 파일만 읽을 수 있어요. 아래 경로는 내 이미지 폴더로 바꿔 넣으세요.

claude mcp add image2svg --scope user -- uvx image2svg-mcp --allow-local-files-path /home/user/images

Claude Desktop은 설정 파일(claude_desktop_config.json)에 아래 블록을 넣고 앱을 다시 켜세요. Cursor 같은 다른 MCP 클라이언트도 같은 형식을 쓰는 곳이 많아요.

{
  "mcpServers": {
    "image2svg": {
      "command": "uvx",
      "args": ["image2svg-mcp"]
    }
  }
}

연결이 됐는지는 Claude Code 안에서 /mcp를 입력하면 볼 수 있어요. Docker로 HTTP 서버를 띄워 연결하는 방법도 있는데, 원문 안내는 저장소 README에 있어요.

사용 예

연결한 뒤에는 말로 부탁하면 돼요. README의 예시를 옮겼어요.

파란 원 안에 흰 별이 들어간 로고를 만들어 줘. 그다음 선명한 가장자리를 위해 binary 색상 모드로 SVG 변환하고, 노이즈를 없애도록 filter_speckle을 10으로 설정해 줘.
이 이미지를 미니멀한 포스터 느낌이 나도록 색상 정밀도를 낮춘 단순한 SVG로 변환해 줘: https://example.com/photo.png
이 로컬 파일을 SVG로 변환해 줘: file://logo.png

마지막 문장은 위에서 --allow-local-files-path로 폴더를 열어 두었을 때만 돼요. 폴더를 열지 않으면 file:// 주소는 거부돼요.

자주 만지는 옵션은 아래 네 가지예요.

옵션기본값효과
colormodecolorbinary로 바꾸면 흑백 선화로 나와요. 로고와 아이콘에 잘 어울려요.
filter_speckle4이 크기(픽셀) 이하의 잡티를 지워요. 올리면 깨끗해지고 작은 디테일은 사라져요.
color_precision6색 단계 수예요. 낮추면 색이 줄어 포스터 느낌이 나고 파일이 단순해져요.
modesplinespline은 부드러운 곡선, polygon은 직선, none은 픽셀 그대로예요.

변환 결과가 마음에 들지 않으면 옵션 값을 말로 바꿔서 다시 시켜 보세요. 같은 변환을 브라우저에서 눈으로 보며 조절해 볼 수 있는 온라인 데모(botmonster.com/image2svg)도 있어요.

알아둘 점

  • 주소(URL)로 받는 이미지는 크기가 5MB로 제한돼요.
  • 지원 형식은 PNG, JPG, JPEG, WEBP, TIFF 같은 일반 래스터 이미지예요.
  • 사진처럼 색이 복잡한 이미지는 변환 결과가 무겁거나 거칠어질 수 있어요. 이때는 color_precision을 낮추거나 filter_speckle을 올려 보세요.
  • 이미지가 내 컴퓨터 밖으로 나가지 않아요. 주소로 넘길 때만 그 주소의 이미지를 내려받아요.

더 보기

확인한 날짜 2026-11-18 · PyPI 최신 v1.0.1 · 라이선스 Apache-2.0

글이 도움이 되었다면 좋아요를 눌러 주세요.