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

Claude CodeNode.js 20 이상다른 MCP 프로그램 ↓

실제로 쓰면

파일이 들어가고, 파일이 나옵니다.

각 도구는 원본 옆에 새 파일을 만들고, 그 경로와 작은 미리보기를 돌려줍니다. 원본을 포함해 어떤 파일도 덮어쓰지 않습니다.

나

~/Desktop/shoe.jpg에서 운동화만 잘라내고, 가벼운 WebP로 만들어 줘.

remove_backgroundshoe.jpg

Saved: ~/Desktop/shoe-cutout.png

1408×768 PNG, 225 KB (input 93 KB)

Transparent background: yes

remove_background로 잘라낸 운동화. 투명한 영역은 체크무늬로 보입니다.

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이고, 배경은 투명하게 남아 있습니다.

MacBook(Apple M2 Max)에서 ruah-mcp 0.1.0을 실제로 돌린 기록입니다. 미리보기는 그때 나온 파일 그대로입니다.

도구

도구 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 literemove_background98 MB서버가 처음 켜질 때 뒤에서
BiRefNetremove_background473 MBlite 모델이 피사체를 못 찾을 때만
Swin2SR ×2upscale 2×8 MB처음 2배 업스케일할 때
Swin2SR ×4upscale 4×55 MB처음 4배 업스케일할 때

compress, resize, crop, strip_metadata는 아무것도 받지 않습니다.

다른 MCP 프로그램

Claude Desktop, Cursor와 그 밖의 프로그램

프로그램의 MCP 서버 설정에 아래를 넣고, 에이전트에게 평소 말투로 이미지 일을 시키면 됩니다.

MCP 설정 · JSON
{
  "mcpServers": {
    "ruah": {
      "command": "npx",
      "args": ["-y", "ruah-mcp"]
    }
  }
}

돌아가는 곳

Node.js 20 이상

macOS · Apple Silicon
시험을 마쳤습니다. 업스케일은 GPU로 돌립니다.
Linux · Windows (x64)
바뀔 때마다 시험합니다. 업스케일은 CPU로 돌립니다.
Intel Mac
지원하지 않습니다. AI 런타임이 인텔 맥용 빌드를 내지 않습니다.
HEIC 사진
macOS에서만 읽습니다.