image2svg-mcp
- 추천0
- GitHub 별11
- 디자인라이선스Apache-2.0
PNG·JPG·WEBP 같은 래스터 이미지를 확대해도 깨지지 않는 SVG 벡터 그래픽으로 바꿔 주는 MCP 서버예요. API 키가 필요 없어요.
설치 방법은 설치 탭에 정리했어요.
설명
image2svg-mcp
래스터 이미지(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_base64 | string | - | - | base64로 인코딩한 이미지 데이터. 이 값 또는 image_url 중 하나를 지정합니다. |
image_url | string | - | - | 이미지를 가져올 URL(http://, https://, 켜 둔 경우 file://). 이 값 또는 image_base64 중 하나를 지정합니다. |
colormode | string | "color" | color, binary | 풀 컬러 또는 흑백 선화 |
mode | string | "spline" | spline, polygon, none | 추적 모드: 부드러운 곡선, 직선 가장자리, 픽셀 단위 그대로 |
filter_speckle | int | 4 | 0-128 | N픽셀 이하의 잡티 제거 |
color_precision | int | 6 | 1-12 | 색상 양자화 비트 수. 낮을수록 색이 적고 SVG가 단순해짐 |
layer_difference | int | 16 | 0-128 | 레이어를 합칠 때 쓰는 색 차이 |
corner_threshold | int | 60 | 0-180 | 모서리 감지 각도 기준(도) |
length_threshold | float | 4.0 | 3.5-10.0 | 경로 선분의 최소 길이 |
splice_threshold | int | 45 | 0-180 | 스플라인 이음 각도 기준 |
path_precision | int | 8 | 1-12 | SVG 좌표의 소수점 자릿수 |
hierarchical | string | "stacked" | stacked, cutout | 레이어 배치 방식 |
max_iterations | int | 10 | 1-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를 참고하세요.