HeyBeauty MCP Server

HeyBeauty MCP服务器

HeyBeauty虚拟试用

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

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

快速开始

1. 申请 HeyButy API密钥

1. 将服务器配置添加到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，用于访问浏览器中的调试工具。