본문으로 건너뛰기
MCP 서버 전체 목록

image2svg-mcp

  • 추천0
  • GitHub 별11
  • 디자인라이선스Apache-2.0

PNG·JPG·WEBP 같은 래스터 이미지를 확대해도 깨지지 않는 SVG 벡터 그래픽으로 바꿔 주는 MCP 서버예요. API 키가 필요 없어요.

원본:botmonster/image2svg-mcp

설치 방법은 설치 탭에 정리했어요.

설명

image2svg-mcp

PyPI Docker License Tests

래스터 이미지(PNG, JPG, WEBP)를 확대해도 깨지지 않는 SVG 벡터 그래픽으로 변환하는 MCP 서버입니다.

주요 기능

  • 이미지를 base64로 인코딩한 데이터 또는 URL로 받습니다.
  • PNG, JPG, JPEG, WEBP, TIFF 등 널리 쓰이는 래스터 형식을 지원합니다.
  • 벡터화 매개변수(색상 정밀도, 잡티 필터링, 추적 모드 등)를 세밀하게 조절할 수 있습니다.
  • data:image/...;base64, URI 접두사를 자동으로 처리합니다.
  • URL 다운로드는 스트리밍으로 받으며 크기를 5MB로 제한합니다.
  • 로컬 이미지를 위한 file:// URL 지원은 선택 사항입니다(--allow-local-files-path로 직접 켜야 합니다).

사용법

실제로 동작하는 모습은 이미지를 SVG로 변환하는 온라인 데모에서 확인할 수 있습니다.

Claude Code와 Claude Desktop

settings.json에 다음을 추가하세요.

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

Claude Code에서는 명령줄로 추가할 수도 있습니다.

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

로컬 파일에 접근하려면 다음과 같이 추가합니다.

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

Docker

HTTP 서버로 실행합니다.

docker run -p 8000:8000 ghcr.io/botmonster/image2svg-mcp

로컬 파일 접근을 함께 켜려면 다음과 같이 합니다.

docker run -p 8000:8000 -v /home/user/images:/images ghcr.io/botmonster/image2svg-mcp --allow-local-files-path /images
claude mcp add image2svg --transport http --scope user http://localhost:8000/mcp

이렇게 하면 다음과 같은 프롬프트를 쓸 수 있습니다.

이 로컬 파일을 SVG로 변환해 줘: file://logo.png

지정한 디렉터리(와 그 하위 디렉터리) 안의 파일만 접근할 수 있고, 경로는 디렉터리 이동 공격(directory traversal)을 막도록 정규화됩니다. 이 옵션이 없으면 file:// URL은 거부됩니다.

프롬프트 예시

LLM에게 이렇게 시킬 수 있습니다.

1. 간단한 이미지→SVG 변환

산 위로 지는 노을 이미지를 만든 다음 SVG로 변환해 줘.

LLM이 래스터 이미지를 만든 뒤, 기본 설정으로 convert_image_to_svg 도구를 써서 깔끔한 벡터 버전을 만듭니다.

2. 매개변수를 지정한 세밀한 변환

파란 원 안에 흰 별이 들어간 로고를 만들어 줘. 그다음 선명한 가장자리를 위해 binary 색상 모드로 SVG 변환하고, 노이즈를 없애도록 filter_speckle을 10으로 설정해 줘.

흑백 선화 스타일의 결과를 내는 colormode: "binary"를 사용하며, 로고와 아이콘에 잘 어울립니다. filter_speckle 값을 높이면 작은 잡티가 사라집니다.

3. URL에서 가져와 미니멀한 스타일로 변환

이 이미지를 미니멀한 포스터 느낌이 나도록 색상 정밀도를 낮춘 단순한 SVG로 변환해 줘: https://example.com/photo.png

color_precision: 3을 쓰면 색 수가 크게 줄어, 포스터처럼 단순화된 예술적인 벡터 효과가 나옵니다. 스타일화된 일러스트에 좋습니다.

4. base64 이미지를 직접 변환

이 base64 이미지를 SVG로 변환해 줘: iVBORw0KGgoAAAANSUhEUgAAAAoAAAAKCAYAAACNMs+9AAAAO0lEQVR4nGP8z8Dwn4EIwESMIqwKGRn+MzBisYQJXRE2NopCbKYgi5Huxv8MjBiSyGJMuCTQNTJSPRwBCjYOD5JU5rIAAAAASUVORK5CYII=

가운데에 파란 원이 있는 10x10 크기의 빨간 사각형입니다. URL 없이 이미지 데이터만으로 도구를 시험해 볼 때 유용합니다.

도구 매개변수

매개변수형식기본값범위설명
image_base64string--base64로 인코딩한 이미지 데이터. 이 값 또는 image_url 중 하나를 지정합니다.
image_urlstring--이미지를 가져올 URL(http://, https://, 켜 둔 경우 file://). 이 값 또는 image_base64 중 하나를 지정합니다.
colormodestring"color"color, binary풀 컬러 또는 흑백 선화
modestring"spline"spline, polygon, none추적 모드: 부드러운 곡선, 직선 가장자리, 픽셀 단위 그대로
filter_speckleint40-128N픽셀 이하의 잡티 제거
color_precisionint61-12색상 양자화 비트 수. 낮을수록 색이 적고 SVG가 단순해짐
layer_differenceint160-128레이어를 합칠 때 쓰는 색 차이
corner_thresholdint600-180모서리 감지 각도 기준(도)
length_thresholdfloat4.03.5-10.0경로 선분의 최소 길이
splice_thresholdint450-180스플라인 이음 각도 기준
path_precisionint81-12SVG 좌표의 소수점 자릿수
hierarchicalstring"stacked"stacked, cutout레이어 배치 방식
max_iterationsint101-100곡선 근사 최대 반복 횟수

개발

설치

git clone https://github.com/botmonster/image2svg-mcp.git
cd image2svg-mcp
uv sync

테스트 실행

uv run pytest tests/ -v

MCP Inspector 실행

uv run fastmcp dev inspector src/image2svg_mcp/server.py:mcp

라이선스

Apache 2.0 - LICENSE를 참고하세요.