mcpField
H
HeyBeauty MCP Server

HeyBeauty MCP Server

精选本地服务
github.com/chatmcp媒体与设计1968 周前更新
代码仓库

关于 HeyBeauty MCP Server

HeyBeauty MCP Server 是一个基于 TypeScript 的 MCP 服务，通过 HeyBeauty API 提供虚拟试衣功能。它面向需要在 MCP 客户端中调用虚拟试衣的开发者和用户。

主要功能

  1. 01以 cloth:// URI 暴露服装资源
  2. 02提供提交试衣任务的工具
  3. 03提供查询试衣任务信息的工具
  4. 04提供用于试衣的结构化提示词

适用场景

  1. 01在 MCP 客户端中为用户图片生成虚拟试衣效果
  2. 02通过任务 ID 查询试衣任务的状态和结果
  3. 03浏览服装资源并将其用于试衣流程

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露服装资源、试衣任务相关工具以及 tryon_cloth 提示词。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "heybeauty": {
      "command": "npx",
      "args": [
        "-y",
        "heybeauty-mcp"
      ],
      "env": {
        "HEYBEAUTY_API_KEY": "<HEYBEAUTY_API_KEY>"
      }
    }
  }
}
启动命令npx -y heybeauty-mcp
需要配置的环境变量
HEYBEAUTY_API_KEY密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmheybeauty-mcp

工具

2

收录的工具列表 · 更新于 3 周前

参数类型必填说明
user_img_urlstring是用户图片 URL，应为图片链接
cloth_img_urlstring是服装图片 URL，应为图片链接；由用户输入或从所选服装资源获取
cloth_idstring否服装 ID，从所选服装资源获取
cloth_descriptionstring否服装描述，由用户输入或从所选服装资源获取

详细介绍

HeyBeauty MCP 服务

HeyBeauty 虚拟试穿

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

  • 表示服装的资源，包含 URI 和元数据
  • 用于提交试穿任务和查询任务信息的工具。
  • 用于试穿服装的提示词。

快速开始

  1. 申请 HeyBeauty 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 和服装描述
    • 返回用于大模型试穿的结构化提示词
资源
  • 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"
    }
  }
}

请按照本文档获取 HeyBeauty API 密钥。

调试

由于 MCP 服务通过 stdio 通信，调试可能比较困难。我们建议使用 MCP Inspector，它可通过包脚本运行：

npm run inspector

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。