AI导哈

虚拟试衣服务

基于HeyBeauty API的虚拟试衣服务，提供衣物资源管理、试衣任务提交与查询以及试衣提示生成功能。

  • by chatmcp
  • JavaScript
  • 本地部署
  • 19 星标
  • 更新于
在 GitHub 查看 chatmcp/heybeauty-mcp

使用说明

HeyBeauty MCP服务器

HeyBeauty虚拟试用

这是一个基于类型脚本的MCP服务器，使用HeyButy API实现虚拟试用。它通过提供以下内容展示了MCP的核心概念：

  • 用URI和元数据表示衣服的资源
  • 提交试用任务和查询任务信息的工具。
  • 试穿布料的提示。

快速开始

  1. 申请 HeyButy API密钥

  2. 将服务器配置添加到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和元数据

发展

安装依赖项：

npm install

构建服务器：

npm run build

对于自动重建的开发：

npm run watch

安装

要与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"
    }
  }
}

按照此文档进行操作 获取HeyButy API密钥.

调试

由于MCP服务器通过stdio进行通信，调试可能具有挑战性。我们建议使用 MCP检查员，可作为包脚本使用：

npm run inspector

检查器将提供一个URL，用于访问浏览器中的调试工具。

相关 MCP