HeyBeauty MCP 服务器

HeyBeauty虚拟试穿

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

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

快速入门

申请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 和衣服描述作为必需参数
- 将 tryon 任务存储在服务器状态
query_tryon_task - 查询 tryon 任务
- 将任务 ID 作为必需参数
- 返回tryon任务信息

提示

tryon_cloth - 特赖恩布
- 将用户图片 url、衣服图片 url、衣服 id 和衣服描述作为必需参数
- 返回 LLM tryon 的结构化提示

资源

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 Key 。

调试

由于 MCP 服务器通过 stdio 进行通信，调试起来可能比较困难。我们推荐使用MCP Inspector ，它以包脚本的形式提供：

npm run inspector

检查器将提供一个 URL 来访问浏览器中的调试工具。

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

基于 TypeScript 的 MCP 服务器，使用 HeyBeauty API 实现虚拟试穿功能，让用户可以通过 Claude 直观地看到衣服穿在身上的效果。

Related MCP Servers

UseScraper MCP Server
tanevanwifferen
A
security
A
license
A
quality
A TypeScript-based MCP server utilizing the UseScraper API to provide web scraping capabilities, allowing users to extract content from webpages in various formats.
Last updated -
1
1
JavaScript
MIT License
FindMine Shopping Stylistofficial
findmine
-
security
-
license
-
quality
An MCP server that integrates FindMine's product styling and outfit recommendation capabilities with Claude and other MCP-compatible applications, allowing users to browse products, get outfit recommendations, find similar items, and access style guidance.
Last updated -
7
1
JavaScript
Dify MCP Server
zhuzhoulin
-
security
-
license
-
quality
A TypeScript-based server that connects MCP Clients to Dify applications, dynamically exposing Dify applications as tools that can be used directly within the MCP Client.
Last updated -
2
JavaScript
MIT License
FastMCP
yamato-snow
-
security
A
license
-
quality
A TypeScript framework for building MCP servers with client session management capabilities, supporting tools definition, authentication, image content, logging, and error handling.
Last updated -
6,371
TypeScript
MIT License

View all related MCP servers

Appeared in Searches

A server that finds and installs other MCP servers

HeyBeauty MCP Server