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.
Unlock the full potential of FindMine Shopping Stylist through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.
Free tier available • No credit card required
A Model Context Protocol (MCP) server that integrates FindMine's powerful product styling and outfitting recommendations with Claude and other MCP-compatible applications.
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:
product:///
URI schemelook:///
URI scheme# Install and run directly (recommended) npx findmine-mcp # Or install globally npm install -g findmine-mcp findmine-mcp
docker run -e FINDMINE_APP_ID=your_app_id findmine/mcp-server:latest
# 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
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 | - |
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
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.
Run the server with sample data:
NODE_ENV=development npm run build && node build/index.js
The style guide can be customized to match your brand's specific styling philosophies and fashion guidance. To customize the style guide:
src/index.ts
(search for styleGuides
)general
, color_theory
, body_types
, etc.)styleGuides
objectExample 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
.
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{ "name": "get_style_guide", "arguments": { "category": "color_theory", "occasion": "wedding" } }
{ "name": "get_complete_the_look", "arguments": { "product_id": "P12345", "product_color_id": "C789" } }
{ "name": "get_visually_similar", "arguments": { "product_id": "P12345", "product_color_id": "C789", "limit": 5 } }
# Login to npm npm login # Publish the package npm publish # Update the version for future releases npm version patch
# 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
This project is licensed under the MIT License.
Discover shared experiences
Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!