fashio-mcp

Fashio API용 MCP(Model Context Protocol) 서버 — Claude, Cursor 등 MCP를 지원하는 에이전트가 도구 호출 형태로 모델 착용 패션 사진을 직접 생성할 수 있게 해 줍니다.

Fashio는 AI로 의류 또는 제품 사진을 바로 게시할 수 있는 이커머스 사진과 비디오로 변환합니다 — 가상 착용(virtual try-on), 카탈로그 팩, 배경 제거, 업스케일링, 리프레이밍(reframing) 등이 포함됩니다. 이 패키지는 해당 공개 v1 REST API의 공식 MCP 클라이언트입니다.

이것은 얇은 래퍼입니다. 여기의 모든 도구는 curl 스크립트가 호출하는 것과 동일한 공개 api.fashiolabs.com v1 REST API를 호출합니다. 로컬 비즈니스 로직은 없습니다 — API가 진실의 원천입니다.

설정

1. fashiolabs.com → Profile → API Keys에서 무료 API 키를 만드세요.

2. Fashio를 MCP 클라이언트에 추가하세요 — 아래 두 옵션 중 하나를 선택하세요.

옵션 A — 원격(호스팅, 설치 불필요)

mcp.fashiolabs.com은 이 동일한 서버를 호스팅된 HTTP 엔드포인트로 실행합니다 — 설치할 것이 없으며, 키를 bearer 토큰으로 포함한 URL만 추가하면 됩니다:

{
  "mcpServers": {
    "fashio": {
      "url": "https://mcp.fashiolabs.com/mcp",
      "headers": {
        "Authorization": "Bearer fio_live_..."
      }
    }
  }
}

(정확한 구성 UI/필드 이름은 클라이언트마다 다릅니다 — Claude Desktop, Claude Code, Cursor는 모두 2026년 기준으로 커스텀 헤더와 함께 URL로 원격/HTTP MCP 서버를 추가하는 것을 지원합니다.)

옵션 B — 로컬(이 패키지, stdio)

호스팅된 엔드포인트 대신 사용자 자신의 머신에서 실행됩니다 — 동일한 도구, 동일한 과금.

Claude Desktop / Claude Code

claude_desktop_config.json(또는 Claude Code용 .mcp.json):

{
  "mcpServers": {
    "fashio": {
      "command": "npx",
      "args": ["-y", "fashio-mcp"],
      "env": {
        "FASHIO_API_KEY": "fio_live_..."
      }
    }
  }
}

소스에서 실행하기

git clone https://github.com/fashiolabs/fashio-mcp.git
cd fashio-mcp
npm install
npm run build

그런 다음 npx 대신 빌드된 엔트리 포인트를 가리키도록 클라이언트 설정을 지정하세요:

{
  "mcpServers": {
    "fashio": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
      "env": { "FASHIO_API_KEY": "fio_live_..." }
    }
  }
}

Related MCP server: Photo AI Studio MCP Server

도구

이 도구들이 래핑하는 전체 엔드포인트 레퍼런스는 docs.fashiolabs.com을 참조하고, LLM이 한 번에 읽도록 작성된 일반 텍스트 버전(각 toolId에 필요한 images.* 필드 포함)은 docs.fashiolabs.com/llms-full.txt을 참조하세요.

과금

별도의 MCP 또는 API 플랜은 없습니다. 모든 create_generation 호출은 API 키를 소유한 계정에서 다이아몬드(Fashio의 크레딧 단위)를 차감합니다 — 앱이나 대시보드에서 생성할 때와 똑같은 방식입니다. 실패한 생성은 다이아몬드를 자동으로 환불합니다.

개발

npm run dev    # tsc --watch
npm run build
npm start      # runs dist/index.js directly (expects FASHIO_API_KEY in env)

링크

• fashiolabs.com — 제품

• docs.fashiolabs.com — 전체 API 레퍼런스

• fashiolabs.com/mcp — MCP 설정 가이드

• fashiolabs.com/pricing — 플랜 및 크레딧 팩

라이선스

MIT — LICENSE 참조.