Heybeauty MCP

HeyBeauty虛擬試衣MCP服務，基於TypeScript實現，提供服裝資源管理、試衣任務提交與查詢功能，集成HeyBeauty API實現虛擬試穿效果。

電子商務與零售圖像與視頻處理 #虛擬試衣 #服裝資源 #任務管理 #API集成本地 .TypeScript

評分 : 2分

下載量 : 8

更新時間 : 2025-04-28

What is HeyBeauty Virtual TryOn?

HeyBeauty Virtual TryOn is an AI-powered service that lets you see how clothes would look on you without physically trying them on. It uses advanced image processing to realistically overlay clothing items onto your photos.

How to use HeyBeauty Virtual TryOn?

Simply provide a photo of yourself and select clothing items you want to try. The system will process your request and show you the results in seconds.

Ideal Use Cases

Perfect for online shopping, fashion consultation, personal styling, and wardrobe planning. Great for both consumers and fashion retailers.

Key Features

Realistic Virtual Try-OnSee how clothes fit and look on your body with high accuracy

Clothing Catalog AccessBrowse and select from a wide range of clothing items

Try-On Task ManagementSubmit and track multiple virtual try-on requests

Pros and Cons

Advantages

Saves time by eliminating physical try-ons

Helps make better purchasing decisions

Works with your existing photos

Supports multiple clothing items

Limitations

Requires clear, well-lit photos for best results

May not perfectly represent fabric texture and drape

Currently supports upper body clothing best

Getting Started

Get API Key

Apply for a HeyBeauty API key from their official website

Configure MCP Client

Add the server configuration to your MCP client settings file

Start Trying On Clothes

Use the tryon_cloth prompt with your image and clothing details

Example Scenarios

Online Shopping AssistantWhile browsing an online store, use virtual try-on to see how items would look before purchasing

Wardrobe PlanningTry on different clothing combinations from your digital wardrobe

Frequently Asked Questions

What kind of photos work best for virtual try-on?

How long does a try-on take to process?

Can I try on multiple items at once?

Helpful Resources

HeyBeauty API Documentation

Official documentation for the HeyBeauty API

MCP Inspector Tool

Debugging tool for MCP servers

Virtual Try-On Best Practices

Tips for getting the best virtual try-on results

🚀 HeyBeauty MCP 服務器

HeyBeauty 虛擬試穿是一個基於 TypeScript 的 MCP 服務器，藉助 HeyBeauty API 實現虛擬試穿功能。該項目通過特定方式演示核心 MCP 概念，為用戶提供便捷的虛擬試穿體驗。

🚀 快速開始

申請 API Key

首先，你需要申請 HeyBeauty API Key。

配置服務器

將服務器配置添加到 MCP 客戶端配置文件中，示例如下：

{
  "mcpServers": {
    "heybeauty-mcp": {
      "command": "npx",
      "args": ["-y", "heybeauty-mcp"],
      "env": {
        "HEYBEAUTY_API_KEY": "your_heybeauty_api_key"
      }
    }
  }
}

資源相關

資源訪問：使用 cloth:// URI 列出和訪問服裝。
資源信息：每件服裝都有 id、名稱、描述、圖片 URL 和元數據。
內容訪問：使用純文本 MIME 類型進行簡單內容訪問。

工具使用

`submit_tryon_task`

該工具用於提交試穿任務，它接受用戶圖片 URL、服裝圖片 URL、服裝 ID 和服裝描述作為必填參數，並將試穿任務存儲在服務器狀態中。

`query_tryon_task`

此工具用於查詢試穿任務，接受任務 ID 作為必填參數，返回試穿任務信息。

提示使用

`tryon_cloth`

該提示用於嘗試穿上衣服，接受用戶圖片 URL、服裝圖片 URL、服裝 ID 和服裝描述作為必填參數，返回用於 LLM 試穿的結構化提示。

💻 使用示例

基礎用法

以下是將服務器配置添加到 MCP 客戶端配置文件的示例：

{
  "mcpServers": {
    "heybeauty-mcp": {
      "command": "npx",
      "args": ["-y", "heybeauty-mcp"],
      "env": {
        "HEYBEAUTY_API_KEY": "your_heybeauty_api_key"
      }
    }
  }
}

高級用法

在與 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"
    }
  }
}

📦 安裝指南

安裝依賴

運行以下命令安裝項目依賴：

npm install

構建服務器

使用以下命令構建服務器：

npm run build

開發模式

若需要帶有自動重建功能的開發模式，可運行：

npm run watch

與 Claude Desktop 集成

與 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"
    }
  }
}