Skip to main content
Glama

mochify-cli

MCP Badge License: MIT

mochify.app을 위한 명령줄 도구이자 MCP 서버입니다. 네이티브 C++ 엔진으로 구동되는 빠르고 개인정보 보호를 우선시하는 이미지 압축 및 변환 API입니다.

터미널에서 이미지를 최신 형식(AVIF, JXL, WebP, Jpegli)으로 압축 및 변환하거나, Model Context Protocol을 통해 Claude와 같은 AI 어시스턴트가 이미지 처리에 직접 액세스하도록 할 수 있습니다.

설치

macOS (Homebrew):

brew tap getmochify/mochify
brew install mochify

Linux / WSL:

# x86_64
curl -L https://github.com/getmochify/mochify-cli/releases/latest/download/mochify-linux-x86_64 -o mochify
chmod +x mochify
sudo mv mochify /usr/local/bin/

# arm64
curl -L https://github.com/getmochify/mochify-cli/releases/latest/download/mochify-linux-arm64 -o mochify
chmod +x mochify
sudo mv mochify /usr/local/bin/

수동 설치: 모든 바이너리는 Releases에서 확인할 수 있습니다.

소스에서 빌드:

cargo install --path .

Related MCP server: tinypng-mcp-server

인증

mochify.app 계정으로 로그인하여 전체 할당량을 잠금 해제하세요:

mochify auth login

브라우저가 열리면 로그인하고 CLI를 승인하세요. 자격 증명은 ~/.config/mochify/credentials.toml에 자동으로 저장되므로 환경 변수나 수동 키 복사가 필요하지 않습니다. CLI와 MCP 서버 모두 이를 자동으로 가져옵니다.

mochify auth status   # check whether you're signed in
mochify auth logout   # remove saved credentials

무료 티어(인증되지 않음)는 하루 25개의 이미지로 제한됩니다. mochify.app에서 가입하세요.

CLI 사용법

mochify [OPTIONS] <FILES>...

옵션

플래그

설명

-t, --type <FORMAT>

출력 형식: jpg, png, webp, avif, jxl

-w, --width <N>

대상 너비(픽셀)

-H, --height <N>

대상 높이(픽셀)

--crop

정확한 치수로 자르기

-r, --rotation <DEG>

회전: 0, 90, 180, 270

-o, --output <DIR>

출력 디렉토리 (기본값: 입력과 동일)

-p, --prompt <TEXT>

자연어 프롬프트 — 매개변수를 자동으로 해결

-k, --api-key <KEY>

API 키 재정의 (또는 MOCHIFY_API_KEY 환경 변수 설정)

예시

# Convert a JPEG to AVIF
mochify photo.jpg -t avif

# Resize and convert to WebP
mochify photo.jpg -t webp -w 800

# Batch convert a folder to AVIF at 1200px wide
mochify ./images/*.jpg -t avif -w 1200 -o ./compressed

# Use a natural-language prompt instead of explicit flags
mochify photo.jpg -p "convert to avif and resize to 1200px wide"

# Prompt works with multiple files too
mochify ./images/*.jpg -p "compress for web, keep under 1000px wide" -o ./out

MCP 서버 (Claude Desktop)

mochify는 MCP 서버로 실행되어 Claude가 대화 중에 직접 이미지를 처리하도록 할 수 있습니다.

설정

먼저 mochify auth login을 실행한 다음, ~/Library/Application Support/Claude/claude_desktop_config.json에 있는 Claude Desktop 설정에 다음을 추가하세요:

{
  "mcpServers": {
    "mochify": {
      "command": "mochify",
      "args": ["serve"]
    }
  }
}

Claude Desktop을 다시 시작하세요. mochify 서버가 연결 항목에 나타나며 저장된 자격 증명을 자동으로 사용합니다.

사용법

이미지의 전체 경로와 함께 원하는 작업을 자연어로 설명하기만 하면 됩니다:

"Convert /Users/me/Desktop/photo.jpg to AVIF at 1000px wide"

"Compress all the JPEGs in /Users/me/projects/blog/images/ to WebP and save them to /Users/me/projects/blog/compressed/"

Claude가 자동으로 squish 도구를 호출합니다.

API

https://api.mochify.xyz/v1/squish의 mochify API로 구동됩니다.

  • 이미지는 메모리 내에서 처리되며 디스크에 저장되지 않습니다.

  • JPEG(Jpegli), AVIF, JXL, WebP 및 PNG 출력을 지원합니다.

  • 이미지당 최대 25MB까지 지원합니다.

웹 인터페이스는 mochify.app을 방문하세요.

Related MCP Connectors

Related MCP Servers