[MCP 사용법] image2svg-mcp — PNG·JPG 이미지를 확대해도 깨지지 않는 SVG로 바꾸기
· 바이브코드 운영팀
AI가 만들어 준 로고를 크게 늘렸더니 가장자리가 뭉개진 적 있나요? image2svg-mcp를 연결하면 AI가 래스터 이미지(PNG, JPG, WEBP)를 확대해도 깨지지 않는 SVG 벡터로 바로 바꿔 줘요. API 키가 필요 없고 내 컴퓨터에서 돌아가요.
출처: 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:// 주소는 거부돼요.
자주 만지는 옵션은 아래 네 가지예요.
| 옵션 | 기본값 | 효과 |
|---|---|---|
colormode | color | binary로 바꾸면 흑백 선화로 나와요. 로고와 아이콘에 잘 어울려요. |
filter_speckle | 4 | 이 크기(픽셀) 이하의 잡티를 지워요. 올리면 깨끗해지고 작은 디테일은 사라져요. |
color_precision | 6 | 색 단계 수예요. 낮추면 색이 줄어 포스터 느낌이 나고 파일이 단순해져요. |
mode | spline | spline은 부드러운 곡선, polygon은 직선, none은 픽셀 그대로예요. |
변환 결과가 마음에 들지 않으면 옵션 값을 말로 바꿔서 다시 시켜 보세요. 같은 변환을 브라우저에서 눈으로 보며 조절해 볼 수 있는 온라인 데모(botmonster.com/image2svg)도 있어요.
알아둘 점
- 주소(URL)로 받는 이미지는 크기가 5MB로 제한돼요.
- 지원 형식은 PNG, JPG, JPEG, WEBP, TIFF 같은 일반 래스터 이미지예요.
- 사진처럼 색이 복잡한 이미지는 변환 결과가 무겁거나 거칠어질 수 있어요. 이때는
color_precision을 낮추거나filter_speckle을 올려 보세요. - 이미지가 내 컴퓨터 밖으로 나가지 않아요. 주소로 넘길 때만 그 주소의 이미지를 내려받아요.
더 보기
- 바이브코드 도구 상세: image2svg-mcp
- 저장소: botmonster/image2svg-mcp
- 패키지: PyPI image2svg-mcp
확인한 날짜 2026-11-18 · PyPI 최신 v1.0.1 · 라이선스 Apache-2.0
글이 도움이 되었다면 좋아요를 눌러 주세요.