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

language-server-mcp
alexwohletz
A
security
A
license
A
quality
TypeScript-based MCP server designed to enhance code editing experiences by providing features such as hover information, code completion, and diagnostics.
Last updated -
3
24
MIT License
mcp-rest-api
dkmaker
A
security
A
license
A
quality
A TypeScript-based MCP server that enables testing of REST APIs through Cline. This tool allows you to test and interact with any REST API endpoints directly from your development environment.
Last updated -
1
84
59
JavaScript
MIT License
MCP Server Playground
psaboia
A
security
F
license
A
quality
A TypeScript-based MCP server designed for experimentation and integration with Calude Desktop and Cursor IDE, offering a modular playground for extending server capabilities.
Last updated -
2
693
7
JavaScript
FindMine Shopping Stylistofficial
findmine
A
security
F
license
A
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 -
3
671
1
JavaScript

View all related MCP servers

Appeared in Searches

A server that finds and installs other MCP servers

HeyBeauty MCP Server