heybeauty-mcp

Heybeauty MCP Server

HeyBeauty virtual try-on connects clothing resources and image-based task submission to MCP clients. Built in TypeScript, heybeauty-mcp lets users submit try-on requests and retrieve task information through the HeyBeauty API.

Server facts

heybeauty-mcp

Project

Author
chatmcp
License
MIT

Tech

Runtime / language
node
Transports
stdio
Remote available
No
Authentication
Not specified

Activity

GitHub stars
19
Last commit
Data as of

Overview

Clothing records and try-on requests form the core of heybeauty-mcp, a TypeScript integration with the HeyBeauty API. It exposes garments as MCP resources under cloth:// URIs, with identifiers, names, descriptions, image URLs, and metadata. These resources use a plain-text MIME type. For task creation, submit_tryon_task requires URLs for both the user's image and the garment image, together with the garment's identifier and description. Submitted tasks are retained in the server's state, linking the clothing information to the request workflow.

A separate tool, query_tryon_task, accepts a task identifier and retrieves information about that task. The tryon_cloth prompt uses the same image and garment inputs as submission, but produces a structured prompt for an LLM. This gives MCP client users distinct interfaces for accessing clothing, submitting requests, looking up tasks, and preparing prompts. The server runs on Node.js and communicates through stdio. Setup requires a HeyBeauty API key, and the documentation includes client configuration guidance for Claude Desktop.

heybeauty-mcp setup notes

  • heybeauty-mcp records stdio only; confirm a network transport upstream before planning remote access.

Related MCP servers