Servidor MCP de HeyBeauty

Prueba virtual de HeyBeauty

Este es un servidor MCP basado en TypeScript que implementa un tryon virtual mediante la API de HeyBeauty. Demuestra los conceptos básicos de MCP al proporcionar:

Recursos que representan ropa con URI y metadatos
Herramientas para enviar tareas de prueba y consultar información de tareas.
Indicaciones para probar tela.

Inicio rápido

Solicitar la clave API de HeyBeauty
Agregue la configuración del servidor al archivo de configuración del cliente MCP

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

Recursos

Lista y acceso a la ropa a través de las URI cloth://
Cada tela tiene un id, nombre, descripción, URL de imagen y metadatos.
Tipo MIME de texto simple para acceso simple al contenido

Herramientas

submit_tryon_task - Enviar una tarea tryon
- Toma la URL de la imagen del usuario, la URL de la imagen de la tela, la identificación de la tela y la descripción de la tela como parámetros obligatorios
- Almacena la tarea tryon en el estado del servidor
query_tryon_task - Consultar una tarea tryon
- Toma el ID de la tarea como parámetro obligatorio
- Devuelve información de la tarea tryon

Indicaciones

tryon_cloth - Tela Tryon
- Toma la URL de la imagen del usuario, la URL de la imagen de la tela, la identificación de la tela y la descripción de la tela como parámetros obligatorios
- Devuelve un mensaje estructurado para el tryon de LLM

Recursos

cloth:// - URI para ropa
- Cada tela tiene un id, nombre, descripción, URL de imagen y metadatos.

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Instalación

Para utilizar con Claude Desktop, agregue la configuración del servidor:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json En 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"
    }
  }
}

Siga este documento para obtener la clave API de HeyBeauty .

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

HeyBeauty MCP Server

Integrations