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.

Related MCP server: Perplexity MCP Server

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

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:

1. Localice las guías de estilo en src/index.ts (busque styleGuides )

2. Modificar el contenido de cada categoría ( general , color_theory , body_types , etc.)

3. Agregue nuevas categorías ampliando el objeto styleGuides

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