HeyBeauty MCP 서버

HeyBeauty 가상 체험

HeyBeauty API를 사용하여 가상 트라이온을 구현하는 TypeScript 기반 MCP 서버입니다. 다음을 제공하여 핵심 MCP 개념을 보여줍니다.

• URI와 메타데이터를 사용하여 옷을 나타내는 리소스

• 트라이온 작업을 제출하고 작업 정보를 쿼리하기 위한 도구입니다.

• 트라이온 천에 대한 메시지입니다.

빠른 시작

1. HeyBeauty API 키 신청

2. MCP 클라이언트 구성 파일에 서버 구성을 추가합니다.

지엑스피1

자원

• cloth:// URI를 통해 옷 나열 및 접근

• 각 천에는 ID, 이름, 설명, 이미지 URL 및 메타데이터가 있습니다.

• 간단한 콘텐츠 액세스를 위한 일반 텍스트 MIME 유형

도구

• submit_tryon_task - tryon 작업 제출

  • 사용자 이미지 URL, 천 이미지 URL, 천 ID 및 천 설명을 필수 매개변수로 사용합니다.

  • 서버 상태에 tryon 작업을 저장합니다.

• query_tryon_task - tryon 작업 쿼리

  • 필수 매개변수로 작업 ID를 사용합니다.

  • tryon 작업 정보를 반환합니다.

프롬프트

• tryon_cloth - 트라이온 천

  • 사용자 이미지 URL, 천 이미지 URL, 천 ID 및 천 설명을 필수 매개변수로 사용합니다.

  • LLM tryon에 대한 구조화된 프롬프트를 반환합니다.

자원

• cloth:// - 옷에 대한 URI

  • 각 천에는 ID, 이름, 설명, 이미지 URL 및 메타데이터가 있습니다.

Related MCP server: mcp-flux-schnell

개발

종속성 설치:

npm install

서버를 빌드하세요:

npm run build

자동 재빌드를 사용한 개발의 경우:

npm run watch

설치

Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.

MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "heybeauty-mcp": {
      "command": "node",
      "args": ["/path/to/heybeauty-mcp/build/index.js"]
    },
    "env": {
      "HEYBEAUTY_API_KEY": "your_heybeauty_api_key"
    }
  }
}

이 문서에 따라 HeyBeauty API 키를 받으세요 .

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector를 사용하는 것이 좋습니다.

npm run inspector

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.