Findmine MCP

🚀 FindMine Shopping Stylist

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

🚀 Quick Start

This MCP server connects to FindMine's styling API and exposes its functionality to large language models via the Model Context Protocol. It enables users to:

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

✨ Features

Resources

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

Tools

• get_style_guide: Access detailed fashion advice and styling guides.
• get_complete_the_look: Get outfit recommendations for products.
• get_visually_similar: Find visually similar products.

Prompts

• outfit_completion: Get style advice for a complete outfit.
• styling_guide: Access comprehensive fashion styling guides.
• 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: Use Docker

docker pull findmine/mcp-server:latest
docker run -it --rm findmine/mcp-server:latest

Option 3: Clone the repository and run

1. Clone the repository:

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. Install dependencies:

   npm install
   

3. Start the server:

   npm start
   

📚 Documentation

Environment Variables

The following are the recommended environment variable configurations:

💻 Usage Examples

Basic Usage

Get Style Guide

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

Get Complete Outfit Recommendations

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

Find Visually Similar Products

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

🔧 Technical Details

Source Code Structure

src/
├── server.js          # Main server file
├── routes/           # API routes
│   ├── index.js      # Main route
│   └── style-guide.js  # Style guide route
└── utils/            # Utility functions
    └── api.js        # FindMine API wrapper

Contribution Guidelines

1. Fork the repository:

   git clone https://github.com/your-repository.git
   cd your-repository
   

2. Create a feature branch:

   git checkout -b feature/your-feature
   

3. Commit changes and push to the origin:

   git add .
   git commit -m "Add your commit message"
   git push origin feature/your-feature
   

4. Create a pull request.

🚀 Release

Publish to npm

# Log in to npm
npm login

# Publish the package
npm publish

# Update the version number for the next release
npm version patch

Publish to Docker Hub

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

# Log in to Docker Hub
docker login

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

📄 License

This project is distributed under the MIT License.