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.

This server cannot be installed

security - not tested

license - not tested

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.

Un servidor MCP que integra las capacidades de recomendación de estilos de productos y atuendos de FindMine con Claude y otras aplicaciones compatibles con MCP, lo que permite a los usuarios explorar productos, obtener recomendaciones de atuendos, encontrar artículos similares y acceder a orientación de estilo.

Related MCP Servers

Shopify Python MCP Server
kishimoto-banana
A
security
A
license
A
quality
MCP server that integrates with Shopify API, allowing Claude Desktop users to retrieve and manipulate product information from Shopify stores.
Last updated -
5
Python
MIT License
Playwright Server
williamvd4
-
security
A
license
-
quality
A MCP server that provides browser automation tools, allowing users to navigate websites, take screenshots, click elements, fill forms, and execute JavaScript through Playwright.
Last updated -
Python
Apache 2.0
Mattermost MCP Server
pvev
-
security
-
license
-
quality
An MCP server that enables Claude and other MCP clients to interact with Mattermost workspaces, providing channel management, messaging capabilities, and topic monitoring functionality.
Last updated -
TypeScript
Agora MCP
Fewsats
-
security
F
license
-
quality
An MCP server that connects AI assistants to SearchAgora, enabling users to search for, discover, and purchase products across the web through natural language conversations.
Last updated -
1
Python

View all related MCP servers

FindMine Shopping Stylist