FindMine Shopping Stylist

What is FindMine Shopping Stylist?

FindMine Shopping Stylist is a Model Context Protocol (MCP) server that integrates FindMine’s product styling and outfitting recommendations with Claude and other MCP-compatible applications. It connects to FindMine’s styling API and exposes functionality such as product browsing, outfit recommendations, and visually similar product discovery to large language models.

How to use FindMine Shopping Stylist?

Install via npx findmine-mcp (recommended), global npm install, Docker, or clone and build from source. Set the FINDMINE_APP_ID environment variable (a demo ID is provided). The server auto‑configures Claude Desktop during installation. For development, run with NODE_ENV=development to use sample data.

Key features of FindMine Shopping Stylist

• Provides product details via product:/// URIs and outfit recommendations via look:/// URIs.
• Offers three tools: get_style_guide, get_complete_the_look, and get_visually_similar.
• Includes three prompts: outfit_completion, styling_guide, and findmine_help.
• Supports configurable caching (enabled by default, 1‑hour TTL).
• Built with MCP SDK 1.24.2, Zod validation, and 100% test coverage on utilities.
• Fully customizable style guide content in src/content/style-guides.ts.

Use cases of FindMine Shopping Stylist

• Get complete outfit recommendations for a specific product.
• Find products visually similar to a given item.
• Access fashion styling guidelines and brand‑specific advice.
• Automate product search and styling advice in AI‑powered shopping assistants.

FAQ from FindMine Shopping Stylist

What do I need to run FindMine Shopping Stylist?

You need Node.js to run via npx or global install, or Docker, plus a FindMine application ID set as the FINDMINE_APP_ID environment variable.

How can I customize the styling advice?

The style guide content in src/content/style-guides.ts can be edited. You can modify existing categories or add new ones by extending the styleGuides object.

Does the server support caching?

Yes. Response caching is enabled by default and can be controlled via the FINDMINE_CACHE_ENABLED and FINDMINE_CACHE_TTL_MS environment variables (default TTL is 1 hour).

What testing tools are used?

The project uses Vitest for testing (unit tests in __tests__/ directories) and provides scripts for watch mode, one‑run tests, and coverage reports.

How do I deploy FindMine Shopping Stylist?

It can be published to npm (npm publish) or Docker Hub (docker push findmine/mcp-server:latest). Environment variables are set at runtime.