Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • TMDB MCP Server
  • MCP Server
  • Ollama MCP Server
  • MCP Atlassian
  • MCP SSH Server
Back to MCP Servers
FindMine Shopping Stylist

FindMine Shopping Stylist

Public
findmine/findmine-mcp

Integrates FindMine's product styling and outfit recommendations with MCP-compatible applications, enabling browsing of products, outfit suggestions, visual similarity searches, and access to detailed fashion guidance through the Model Context Protocol.

javascript
0 tools
May 30, 2025
Updated Jun 4, 2025

Supercharge Your AI with FindMine Shopping Stylist

MCP Server

Unlock the full potential of FindMine Shopping Stylist through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

FindMine Shopping Stylist

A Model Context Protocol (MCP) server that integrates FindMine's powerful product styling and outfitting recommendations with Claude and other MCP-compatible applications.

Overview

This MCP server connects to FindMine's styling API and exposes its functionality to Large Language Models through the Model Context Protocol. It allows users to:

  • Browse product and outfit information
  • Get outfit recommendations for specific products
  • Find visually similar products
  • Access style guidance and fashion advice

Features

Resources

  • Products: Detailed product information with product:/// URI scheme
  • Looks: Complete outfit recommendations with look:/// URI scheme

Tools

  • get_style_guide: Access detailed fashion advice and styling guidelines
  • get_complete_the_look: Get outfit recommendations for a product
  • get_visually_similar: Find visually similar products

Prompts

  • outfit_completion: Get styling advice for complete outfits
  • styling_guide: Access comprehensive fashion styling guidelines
  • findmine_help: Learn how to use FindMine's tools and resources

Installation

Option 1: Install from npm

# Install and run directly (recommended) npx findmine-mcp # Or install globally npm install -g findmine-mcp findmine-mcp

Option 2: Run with Docker

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

Option 3: Clone and build from source

# 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

Configuration

Environment Variables

VariableDescriptionDefault
FINDMINE_API_URLFindMine API base URLhttps://api.findmine.com
FINDMINE_APP_IDYour FindMine application IDDEMO_APP_ID
FINDMINE_API_VERSIONAPI version to usev3
FINDMINE_DEFAULT_REGIONDefault region codeus
FINDMINE_DEFAULT_LANGUAGEDefault language codeen
FINDMINE_CACHE_ENABLEDEnable response cachingtrue
FINDMINE_CACHE_TTL_MSCache time-to-live in ms3600000 (1 hour)
NODE_ENVSet to "development" for sample data-

Usage with Claude Desktop

The server automatically configures Claude Desktop during installation. To verify:

macOS:

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

Windows:

type %APPDATA%\Claude\claude_desktop_config.json

Development

MCP Inspector

The MCP Inspector is a development tool for testing your server:

npm run inspector

This will open a web interface at http://localhost:5173 where you can interact with your server.

Development Mode

Run the server with sample data:

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

Customizing the Style Guide

The style guide can be customized to match your brand's specific styling philosophies and fashion guidance. To customize the style guide:

  1. Locate the style guides in src/index.ts (search for styleGuides)
  2. Modify the content for each category (general, color_theory, body_types, etc.)
  3. Add new categories by extending the styleGuides object
  4. Customize occasion-specific and seasonal advice

Example of adding a custom style guide category:

// In src/index.ts const styleGuides: Record = { // 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 ` };

For complete customization, you can modify the entire get_style_guide handler in src/index.ts.

Project Structure

  • src/index.ts: Main MCP server implementation
  • src/api/: FindMine API client
  • src/services/: Business logic and service layer
  • src/types/: TypeScript type definitions
  • src/utils/: Utility functions and helpers

API Examples

Get Style Guide

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

Get Complete the Look

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

Get Visually Similar Products

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

Publishing

Publishing to npm

# Login to npm npm login # Publish the package npm publish # Update the version for future releases npm version patch

Publishing to 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

License

This project is licensed under the MIT License.

Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • TMDB MCP Server
    TMDB MCP Server

    Provides AI assistants with seamless access to The Movie Database API via Model Context Protocol, en...

    Added May 30, 2025
  • MCP Server
    MCP Server

    Provides greeting-related tools, resources, and prompts via Model Context Protocol (MCP), enabling p...

    Added May 30, 2025
  • Ollama MCP Server
    Ollama MCP Server

    Enables seamless integration of local Ollama LLM models with MCP-compatible applications, offering m...

    Added May 30, 2025
  • MCP Atlassian
    MCP Atlassian

    Model Context Protocol server enabling AI agents to seamlessly interact with Atlassian products like...

    Added May 30, 2025
  • MCP SSH Server
    MCP SSH Server

    Secure Model Context Protocol (MCP) SSH server enabling remote command execution, file and directory...

    Added May 30, 2025