HeyBeauty MCP Server

by chatmcp
MIT License
38
4
  • Apple

Integrations

  • Implements a virtual try-on service for clothes using the HeyBeauty API, allowing users to visualize how clothing items would look on them through image processing.

HeyBeauty MCP Server

HeyBeauty Virtual TryOn

This is a TypeScript-based MCP server that implements virtual tryon using HeyBeauty API. It demonstrates core MCP concepts by providing:

  • Resources representing clothes with URIs and metadata
  • Tools for submit tryon task and query task info.
  • Prompts for tryon cloth.

Quick Start

  1. apply for HeyBeauty API Key
  2. add the server config to MCP Client config file
{ "mcpServers": { "heybeauty-mcp": { "command": "npx", "args": ["-y", "heybeauty-mcp"], "env": { "HEYBEAUTY_API_KEY": "your_heybeauty_api_key" } } } }

Resources

  • List and access clothes via cloth:// URIs
  • Each cloth has a id, name, description, image url and metadata
  • Plain text mime type for simple content access

Tools

  • submit_tryon_task - Submit a tryon task
    • Takes user image url, cloth image url, cloth id and cloth description as required parameters
    • Stores tryon task in server state
  • query_tryon_task - Query a tryon task
    • Takes task id as required parameter
    • Returns tryon task info

Prompts

  • tryon_cloth - Tryon cloth
    • Takes user image url, cloth image url, cloth id and cloth description as required parameters
    • Returns structured prompt for LLM tryon

Resources

  • cloth:// - URI for clothes
    • Each cloth has a id, name, description, image url and metadata

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On 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" } } }

Follow this document to get HeyBeauty API Key.

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

-
security - not tested
A
license - permissive license
-
quality - not tested

A TypeScript-based MCP server that implements virtual try-on capabilities using the HeyBeauty API, allowing users to visualize how clothes would look on them through Claude.

  1. Quick Start
    1. Resources
    2. Tools
    3. Prompts
    4. Resources
  2. Development
    1. Installation
      1. Debugging

    Related MCP Servers

    • A
      security
      A
      license
      A
      quality
      A TypeScript-based MCP server utilizing the UseScraper API to provide web scraping capabilities, allowing users to extract content from webpages in various formats.
      Last updated -
      1
      1
      JavaScript
      MIT License
      • Apple
    • -
      security
      -
      license
      -
      quality
      An MCP server that integrates FindMine's product styling and outfit recommendation capabilities with Claude and other MCP-compatible applications, allowing users to browse products, get outfit recommendations, find similar items, and access style guidance.
      Last updated -
      7
      1
      JavaScript
    • -
      security
      -
      license
      -
      quality
      A TypeScript-based server that connects MCP Clients to Dify applications, dynamically exposing Dify applications as tools that can be used directly within the MCP Client.
      Last updated -
      2
      JavaScript
      MIT License
    • -
      security
      A
      license
      -
      quality
      A TypeScript framework for building MCP servers with client session management capabilities, supporting tools definition, authentication, image content, logging, and error handling.
      Last updated -
      6,371
      TypeScript
      MIT License

    View all related MCP servers

    ID: q78az0c8ci