Provides containerized deployment of the FindMine MCP server through Docker Hub, simplifying setup and configuration across environments.
Allows cloning and building the MCP server from source code hosted on GitHub.
Supports automatic configuration of Claude Desktop on macOS systems, with specific paths for configuration files.
Enables installation and distribution of the FindMine MCP server through npm, with support for global installation and direct execution.
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
Option 2: Run with Docker
Option 3: Clone and build from source
Configuration
Environment Variables
Variable | Description | Default |
---|---|---|
FINDMINE_API_URL | FindMine API base URL | https://api.findmine.com |
FINDMINE_APP_ID | Your FindMine application ID | DEMO_APP_ID |
FINDMINE_API_VERSION | API version to use | v3 |
FINDMINE_DEFAULT_REGION | Default region code | us |
FINDMINE_DEFAULT_LANGUAGE | Default language code | en |
FINDMINE_CACHE_ENABLED | Enable response caching | true |
FINDMINE_CACHE_TTL_MS | Cache time-to-live in ms | 3600000 (1 hour) |
NODE_ENV | Set to "development" for sample data | - |
Usage with Claude Desktop
The server automatically configures Claude Desktop during installation. To verify:
macOS:
Windows:
Development
MCP Inspector
The MCP Inspector is a development tool for testing your server:
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:
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:
- Locate the style guides in
src/index.ts
(search forstyleGuides
) - Modify the content for each category (
general
,color_theory
,body_types
, etc.) - Add new categories by extending the
styleGuides
object - Customize occasion-specific and seasonal advice
Example of adding a custom style guide category:
For complete customization, you can modify the entire get_style_guide
handler in src/index.ts
.
Project Structure
src/index.ts
: Main MCP server implementationsrc/api/
: FindMine API clientsrc/services/
: Business logic and service layersrc/types/
: TypeScript type definitionssrc/utils/
: Utility functions and helpers
API Examples
Get Style Guide
Get Complete the Look
Get Visually Similar Products
Publishing
Publishing to npm
Publishing to Docker Hub
License
This project is licensed under the MIT License.
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.
An MCP server that integrates FindMine's product styling and outfit recommendation capabilities with Claude and other MCP-compatible applications, allowing users to browse products, get outfit recommendations, find similar items, and access style guidance.
Related MCP Servers
- AsecurityAlicenseAqualityThe Search MCP Server enables seamless integration of network and local search capabilities in tools like Claude Desktop and Cursor, utilizing the Brave Search API for high-concurrency and asynchronous requests.Last updated -171PythonMIT License
- AsecurityAlicenseAqualityAn MCP server that enables Claude to perform web searches using Perplexity's API with intelligent model selection based on query intent and support for domain and recency filtering.Last updated -61JavaScriptMIT License
- -securityFlicense-qualityAn MCP server that integrates with Claude to provide smart documentation search capabilities across multiple AI/ML libraries, allowing users to retrieve and process technical information through natural language queries.Last updated -Python
- -securityAlicense-qualityAn MCP server that integrates with Sonar API to provide Claude with real-time web search capabilities for comprehensive research.Last updated -2JavaScriptMIT License