HeyBeauty MCP Server

虚拟试穿

这是一个基于TypeScript的MCP服务器，使用HeyBeauty API实现虚拟试穿。它通过提供以下内容来展示核心MCP概念：

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

快速开始

1. 申请HeyBeauty API Key

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",
      "path": ["/path/to/heybeauty-mcp/build/index.js"]
    },
    "env": {
      "HEYBEAUTY_API_KEY": "your_heybeauty_api_key"
    }
  }
}

按照此文档获取HeyBeauty API Key。

调试

由于MCP服务器通过标准I/O通信，调试可能会很困难。我们推荐使用MCP Inspector，它作为一个包脚本可用：

npm run inspector

Inspector将提供一个URL，以便您可以在浏览器中访问调试工具。