HeyBeauty MCP Server
2025.04.26
5
JavaScript虚拟试衣娱乐功能
HeyBeauty MCP Server 是一个基于 TypeScript 的 MCP 服务器，通过 HeyBeauty API 实现虚拟试衣功能。它展示了核心 MCP 概念，包括提供衣物资源、提交试衣任务和查询任务信息的工具，以及生成试衣提示的功能。
View on GitHub
Overview
基本能力
产品定位
HeyBeauty MCP Server 是一个虚拟试衣服务，通过 API 实现衣物试穿效果展示。
核心功能
- 提供衣物资源，每个衣物有唯一的 URI 和元数据
- 提供提交试衣任务和查询任务信息的工具
- 生成试衣提示，用于大语言模型试衣
适用场景
- 电商平台的虚拟试衣功能
- 服装设计预览
- 个人虚拟试衣体验
工具列表
submit_tryon_task: 提交试衣任务，需要用户图片 URL、衣物图片 URL、衣物 ID 和衣物描述query_tryon_task: 查询试衣任务，需要任务 IDtryon_cloth: 生成试衣提示，需要用户图片 URL、衣物图片 URL、衣物 ID 和衣物描述
常见问题解答
- 需要申请 HeyBeauty API Key 才能使用服务
- 调试建议使用 MCP Inspector 工具
使用教程
使用依赖
- 申请 HeyBeauty API Key: 获取 API Key
安装教程
- 安装依赖:
npm install
- 构建服务器:
npm run build
- 开发时自动重建:
npm run watch
调试方式
使用 MCP Inspector 进行调试:
npm run inspector