🚀 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 试穿的结构化提示。
资源说明
cloth:// 是表示服装的 URI，每件服装都有 id、名称、描述、图片 URL 和元数据。
📦 安装指南
与 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"
}
}
}
请按照文档 获取 HeyBeauty API Key。
调试说明
由于 MCP 服务器通过 stdio 进行通信，调试可能具有挑战性。我们推荐使用 MCP Inspector，该工具可通过以下命令获得：
npm run inspector
Inspector 将提供一个访问调试工具的 URL，你在浏览器中打开即可进行调试。
🔧 开发步骤
安装依赖
npm install
构建服务器
npm run build
开发模式
带有自动重建功能的开发，可使用以下命令：
npm run watch