HeyBeauty MCP 服务器

HeyBeauty 虚拟试穿

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

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

快速开始

1. 申请 HeyBeauty API 密钥

2. 将服务器配置添加到 MCP 客户端配置文件中

json { "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 和元数据

开发

安装依赖项：

bash npm install

构建服务器：

bash npm run build

开发时自动重建：

bash npm run watch

安装

要与 Claude Desktop 一起使用，请添加服务器配置：

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

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 服务器通过标准输入输出进行通信，调试可能会有挑战。我们建议使用 MCP Inspector，它作为一个包脚本提供：

bash npm run inspector

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

服务配置

[{'mcpServers': {'heybeauty-mcp': {'args': ['-y', 'heybeauty-mcp'], 'command': 'npx', 'env': {'HEYBEAUTY_API_KEY': 'your_heybeauty_api_key'}}}}, {'mcpServers': {'env': {'HEYBEAUTY_API_KEY': 'your_heybeauty_api_key'}, 'heybeauty-mcp': {'args': ['/path/to/heybeauty-mcp/build/index.js'], 'command': 'node'}}}]

来源

• 来源：github
• 链接：https://github.com/chatmcp/heybeauty-mcp