Estilista de compras de FindMine

Un servidor de Protocolo de Contexto de Modelo (MCP) que integra las potentes recomendaciones de estilo y equipamiento de productos de FindMine con Claude y otras aplicaciones compatibles con MCP.

Descripción general

Este servidor MCP se conecta a la API de estilos de FindMine y expone su funcionalidad a grandes modelos de lenguaje mediante el Protocolo de Contexto de Modelo. Permite a los usuarios:

Explorar información sobre productos y conjuntos
Obtenga recomendaciones de atuendos para productos específicos
Encuentre productos visualmente similares
Accede a orientación sobre estilo y consejos de moda.

Características

Recursos

Productos : Información detallada del producto con el esquema URI product:///
Looks : Recomendaciones completas de atuendos con el esquema URI look:///

Herramientas

get_style_guide : Accede a consejos de moda detallados y pautas de estilo.
get_complete_the_look : Obtén recomendaciones de atuendos para un producto
get_visually_similar : Encuentra productos visualmente similares

Indicaciones

outfit_completion : Obtén consejos de estilo para conjuntos completos
guía_de_estilo : Acceda a pautas completas de estilo de moda
findmine_help : Aprenda a utilizar las herramientas y recursos de FindMine

Instalación

Opción 1: Instalar desde npm

# Install and run directly (recommended)
npx findmine-mcp

# Or install globally
npm install -g findmine-mcp
findmine-mcp

Opción 2: Ejecutar con Docker

docker run -e FINDMINE_APP_ID=your_app_id findmine/mcp-server:latest

Opción 3: Clonar y compilar desde la fuente

# Clone the repository
git clone https://github.com/findmine/findmine-mcp.git
cd findmine-mcp

# Install dependencies
npm install

# Build the server
npm run build

# For development with auto-rebuild
npm run watch

Configuración

Variables de entorno

Variable	Descripción	Por defecto
`FINDMINE_API_URL`	URL base de la API de FindMine	https://api.findmine.com
`FINDMINE_APP_ID`	Su ID de aplicación de FindMine	ID DE APLICACIÓN DEMO
`FINDMINE_API_VERSION`	Versión de API a utilizar	versión 3
`FINDMINE_DEFAULT_REGION`	Código de región predeterminado	a nosotros
`FINDMINE_DEFAULT_LANGUAGE`	Código de idioma predeterminado	en
`FINDMINE_CACHE_ENABLED`	Habilitar el almacenamiento en caché de respuestas	verdadero
`FINDMINE_CACHE_TTL_MS`	Tiempo de vida de la caché en ms	3600000 (1 hora)
`NODE_ENV`	Establecer en "desarrollo" para datos de muestra	-

Uso con Claude Desktop

El servidor configura automáticamente Claude Desktop durante la instalación. Para verificar:

macOS:

cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

Ventanas:

type %APPDATA%\Claude\claude_desktop_config.json

Desarrollo

Inspector de MCP

El Inspector MCP es una herramienta de desarrollo para probar su servidor:

npm run inspector

Esto abrirá una interfaz web en http://localhost:5173 donde podrá interactuar con su servidor.

Modo de desarrollo

Ejecute el servidor con datos de muestra:

NODE_ENV=development npm run build && node build/index.js

Personalización de la Guía de Estilo

La guía de estilo se puede personalizar para que se ajuste a las filosofías de estilo y las directrices de moda específicas de su marca. Para personalizar la guía de estilo:

Localice las guías de estilo en src/index.ts (busque styleGuides )
Modificar el contenido de cada categoría ( general , color_theory , body_types , etc.)
Agregue nuevas categorías ampliando el objeto styleGuides
Personalice el asesoramiento según la ocasión y la temporada.

Ejemplo de cómo agregar una categoría de guía de estilo personalizada:

// In src/index.ts
const styleGuides: Record<string, string> = {
  // Existing categories...
  
  // Add your custom category
  your_brand_style: `# Your Brand Style Guide
  
## Brand Aesthetic
- Key elements of your brand's visual identity
- Core style principles
- Signature looks and combinations

## Your Brand's Styling Do's
- Brand-specific styling recommendations
- Preferred color combinations
- Signature styling techniques

## Your Brand's Styling Don'ts
- Combinations to avoid
- Styling approaches that don't align with brand identity
- Common styling mistakes to avoid
`
};

Para una personalización completa, puede modificar todo el controlador get_style_guide en src/index.ts .

Estructura del proyecto

src/index.ts : Implementación del servidor MCP principal
src/api/ : Cliente de API de FindMine
src/services/ : Lógica de negocios y capa de servicio
src/types/ : definiciones de tipos de TypeScript
src/utils/ : Funciones de utilidad y ayudantes

Ejemplos de API

Obtener la guía de estilo

{
  "name": "get_style_guide",
  "arguments": {
    "category": "color_theory",
    "occasion": "wedding"
  }
}

Completa el look

{
  "name": "get_complete_the_look",
  "arguments": {
    "product_id": "P12345",
    "product_color_id": "C789"
  }
}

Obtenga productos visualmente similares

{
  "name": "get_visually_similar",
  "arguments": {
    "product_id": "P12345",
    "product_color_id": "C789",
    "limit": 5
  }
}

Publicación

Publicación en npm

# Login to npm
npm login

# Publish the package
npm publish

# Update the version for future releases
npm version patch

Publicación en Docker Hub

# Build the Docker image
docker build -t findmine/mcp-server:latest .

# Login to Docker Hub
docker login

# Push the image
docker push findmine/mcp-server:latest

Licencia

Este proyecto está licenciado bajo la licencia MIT.