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

apply for HeyBeauty API Key
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.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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.

Related MCP Servers

UseScraper MCP Server
tanevanwifferen
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
FindMine Shopping Stylistofficial
findmine
-
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
Dify MCP Server
zhuzhoulin
-
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
FastMCP
yamato-snow
-
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

Appeared in Searches

A server that finds and installs other MCP servers

HeyBeauty MCP Server