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

1. Solicitar la clave API de HeyBeauty

2. 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.

Related MCP server: mcp-flux-schnell

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.