Heybeauty MCP

🚀 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 试穿的结构化提示。

💻 使用示例

基础用法

以下是将服务器配置添加到 MCP 客户端配置文件的示例：

{
  "mcpServers": {
    "heybeauty-mcp": {
      "command": "npx",
      "args": ["-y", "heybeauty-mcp"],
      "env": {
        "HEYBEAUTY_API_KEY": "your_heybeauty_api_key"
      }
    }
  }
}

高级用法

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

📦 安装指南

安装依赖

运行以下命令安装项目依赖：

npm install

构建服务器

使用以下命令构建服务器：

npm run build

开发模式

若需要带有自动重建功能的开发模式，可运行：

npm run watch

与 Claude Desktop 集成

与 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，在您的浏览器中打开即可。