AI 에이전트용 · MCP 서버
에이전트도 Ruah를 쓸 수 있습니다.
ruah-mcp는 이 사이트의 엔진을 MCP 서버로 묶은 것입니다. Claude Code, Cursor 같은 MCP 프로그램에게 이미지 누끼, 압축, 크기 조정, 자르기, 업스케일, 정리를 맡겨 보세요. 모든 처리는 내 컴퓨터에서 이뤄지고, 이미지는 밖으로 나가지 않습니다.
claude mcp add ruah -- npx -y ruah-mcp또는 플러그인으로 — 도구를 이어 쓰는 스킬이 함께 깔립니다
claude plugin marketplace add 0-big/ruah-mcpclaude plugin install ruah@ruah-tools실제로 쓰면
파일이 들어가고, 파일이 나옵니다.
각 도구는 원본 옆에 새 파일을 만들고, 그 경로와 작은 미리보기를 돌려줍니다. 원본을 포함해 어떤 파일도 덮어쓰지 않습니다.
~/Desktop/shoe.jpg에서 운동화만 잘라내고, 가벼운 WebP로 만들어 줘.
remove_backgroundshoe.jpg
Saved: ~/Desktop/shoe-cutout.png
1408×768 PNG, 225 KB (input 93 KB)
Transparent background: yes

compressshoe-cutout.png · webp−92%
Saved: ~/Desktop/shoe-cutout-compressed.webp
WebP 1408×768: 225 KB → 19 KB (92% smaller)
완료했습니다. shoe-cutout-compressed.webp는 19 KB이고, 배경은 투명하게 남아 있습니다.
도구
도구 6개, 이 사이트와 같은 엔진.
웹 도구와 같은 모델, 인코더, 설정을 씁니다. 이미지 한 장에 144MP, 512MB까지 받습니다.
- remove_backgroundAI · 98 MB 모델
사진에서 주된 피사체만 잘라내 투명 PNG로 저장합니다.
웹에서 누끼 - compress다운로드 없음
눈에 띄는 손실 없이 용량을 줄이거나, WebP, AVIF, JPEG, PNG로 바꿉니다.
웹에서 압축 - resize다운로드 없음
비율을 지키며 픽셀 크기를 바꿉니다. 긴 변 기준 또는 퍼센트로.
웹에서 크기 조정 - crop다운로드 없음
비율이나 정확한 영역으로 자르고, 90도 단위로 돌리고, 뒤집습니다. 픽셀을 옮길 뿐 다시 계산하지 않습니다.
웹에서 자르기 - upscaleAI · 8 또는 55 MB 모델
AI 초해상도로 2배, 4배 키우고 투명도를 지킵니다. 결과는 4096 × 4096까지.
웹에서 업스케일 - strip_metadata다운로드 없음
EXIF(GPS 위치, 카메라, 날짜), XMP, IPTC, 썸네일을 지웁니다. JPEG와 PNG는 다시 인코딩하지 않고 정리합니다.
웹에서 메타데이터 제거
네트워크로 오가는 것
이미지는 내 컴퓨터 밖으로 나가지 않습니다.
오가는 것은 AI 모델 파일뿐이고, 그것도 Ruah의 모델 미러에서 한 번만 받습니다. 받은 파일은 패키지에 고정된 SHA-256 해시와 맞춰 본 뒤에 쓰고, 로컬 캐시에 둡니다.
~/.cache/ruah/models
| 모델 | 쓰는 도구 | 크기 | 받는 때 |
|---|---|---|---|
| BiRefNet lite | remove_background | 98 MB | 서버가 처음 켜질 때 뒤에서 |
| BiRefNet | remove_background | 473 MB | lite 모델이 피사체를 못 찾을 때만 |
| Swin2SR ×2 | upscale 2× | 8 MB | 처음 2배 업스케일할 때 |
| Swin2SR ×4 | upscale 4× | 55 MB | 처음 4배 업스케일할 때 |
compress, resize, crop, strip_metadata는 아무것도 받지 않습니다.
다른 MCP 프로그램
Claude Desktop, Cursor와 그 밖의 프로그램
프로그램의 MCP 서버 설정에 아래를 넣고, 에이전트에게 평소 말투로 이미지 일을 시키면 됩니다.
{
"mcpServers": {
"ruah": {
"command": "npx",
"args": ["-y", "ruah-mcp"]
}
}
}돌아가는 곳
Node.js 20 이상
- macOS · Apple Silicon
- 시험을 마쳤습니다. 업스케일은 GPU로 돌립니다.
- Linux · Windows (x64)
- 바뀔 때마다 시험합니다. 업스케일은 CPU로 돌립니다.
- Intel Mac
- 지원하지 않습니다. AI 런타임이 인텔 맥용 빌드를 내지 않습니다.
- HEIC 사진
- macOS에서만 읽습니다.