FindMine Shopping Stylist

Instructions

Implementation Reference

• src/index.ts:1183-1509 (handler)

  The primary handler function for the 'get_style_guide' tool. It processes input arguments (category, occasion, fashion_season), selects and customizes pre-defined style guide markdown content based on parameters, and returns it as MCP text content.
  function handleGetStyleGuide(args: any) { // Extract and validate parameters with defaults const category = args.category ?? 'general'; const occasion = args.occasion; const fashion_season = args.fashion_season; logger.error(`Getting style guide for category: ${category}${occasion ? `, occasion: ${occasion}` : ''}${fashion_season ? `, season: ${fashion_season}` : ''}`); let styleGuidePrompt = `Provide detailed styling advice`; if (category !== 'general') { styleGuidePrompt += ` about ${category.replace(/_/g, ' ')}`; } if (occasion) { styleGuidePrompt += ` for ${occasion.replace(/_/g, ' ')} occasions`; } if (fashion_season) { styleGuidePrompt += ` during ${fashion_season.replace(/_/g, ' ')}`; } // Create style guides for different categories const styleGuides: Record<string, string> = { general: `# General Style Guide ## Understanding Customer Needs - Listen carefully to what the customer is looking for - Consider their personal style, body type, and preferences - Ask about specific occasions they're shopping for - Look for cues about their comfort level with different styles ## Creating Cohesive Outfits - Balance proportions (fitted with loose) - Create visual interest with textures and layers - Ensure color harmony across the outfit - Consider the visual weight of different pieces ## Color Theory Basics - Complementary colors create vibrant looks (opposites on the color wheel) - Analogous colors create harmonious looks (neighbors on the color wheel) - Neutrals (black, white, gray, beige) work with almost everything - Consider the customer's skin tone when recommending colors ## Accessorizing - Use accessories to add personal style to basic outfits - Consider scale - smaller accessories for petite frames, bolder pieces for larger frames - Balance statement pieces with simpler items - Ensure metals coordinate (gold, silver, rose gold) ## Seasonal Considerations - Layer pieces for transitional seasons - Consider fabric weight and texture for different weather conditions - Adapt color palettes to seasonal trends - Recommend versatile pieces that work across seasons when possible`, color_theory: `# Color Theory Style Guide ## Color Wheel Basics - Primary colors: Red, blue, yellow - Secondary colors: Green, purple, orange - Tertiary colors: Combinations of primary and secondary ## Color Combinations - Complementary: Opposite on the color wheel (blue/orange, red/green) - Analogous: Next to each other on the wheel (blue/teal/green) - Triadic: Equally spaced around the wheel (red/yellow/blue) - Monochromatic: Different shades of the same color ## Skin Tone Considerations - Warm undertones: Gold jewelry looks better, colors like coral, olive, cream - Cool undertones: Silver jewelry looks better, colors like blue, purple, true white - Neutral undertones: Can wear most colors successfully ## Color Psychology - Red: Energy, passion, attention-grabbing - Blue: Calm, trust, professionalism - Green: Growth, freshness, wealth - Black: Sophistication, formality, slimming - White: Purity, simplicity, cleanliness ## Practical Applications - Use color blocking for bold, modern looks - Create focal points with bright accent colors - Use neutrals as a base for versatile wardrobes - Create depth with different shades of the same color family`, body_types: `# Body Types Style Guide ## Common Body Types ### Apple Shape - Carries weight around the middle - Often has slender legs and arms - Style goals: Define waistline, elongate the torso #### Recommendations: - V-neck tops to draw the eye up and down - Empire waist dresses and tops - Straight or bootcut pants - A-line skirts and dresses - Structured jackets that hit at the hip ### Pear Shape - Narrower shoulders and upper body - Wider hips and thighs - Style goals: Balance upper and lower body #### Recommendations: - Boat neck and off-shoulder tops to broaden shoulders - A-line skirts that skim over hips - Dark colors on bottom, brighter on top - Statement necklaces to draw attention up - Fit and flare dresses ### Hourglass Shape - Balanced shoulders and hips with defined waist - Style goals: Highlight natural curves #### Recommendations: - Wrap dresses and tops - Belt to accentuate waist - Fitted clothing that follows natural curves - High-waisted bottoms - Pencil skirts ### Rectangle Shape - Similar measurements at shoulders, waist, and hips - Style goals: Create curves and definition #### Recommendations: - Peplum tops to create waist definition - Layered looks to add dimension - Tops with embellishments or details - Belt at the waist to create definition - Full or A-line skirts to create curves ### Inverted Triangle Shape - Broader shoulders and narrower hips - Style goals: Balance upper and lower body #### Recommendations: - A-line and full skirts to add volume to lower body - Avoid boat necks and halter tops - Draw attention to the waist and lower body - V-necks and scoop necks to soften shoulders - Darker colors on top, lighter on bottom ## General Tips - Focus on fit above all else - Use color and pattern strategically to highlight or minimize areas - Consider scale of prints based on body size - Tailoring can transform fit issues - Dress for your current size, not aspirational sizes`, casual_outfits: `# Casual Outfit Style Guide ## Everyday Casual - Jeans + T-shirt + sneakers: The classic casual foundation - Elevated with: Quality materials, proper fit, thoughtful accessories - Key pieces: Well-fitting jeans, solid and striped tees, clean sneakers ## Smart Casual - Blending casual and dressier elements - Women: Dark jeans + blouse + ankle boots or flats - Men: Chinos + button-down or polo + loafers or clean sneakers - Key accessories: Watch, simple jewelry, leather belt ## Athleisure - Athletic wear styled for everyday wear - Leggings or joggers + fitted tee or tank + structured jacket - Focus on: High-quality fabrics, monochromatic color schemes - Avoid: Worn workout shoes, actual gym clothes ## Weekend Casual - Comfort-focused but still put-together - Boyfriend jeans + oversized sweater + ankle boots - Cargo pants + hoodie + sneakers - Layer with: Denim jacket, field jacket, or cardigan ## Casual for Different Settings ### Coffee Shop - Jeans + sweater + ankle boots - Add a scarf or statement bag for personality ### Shopping - Comfortable shoes (white sneakers, loafers) - Easy-to-remove layers for trying on clothes - Crossbody bag to keep hands free ### Casual Lunch - Elevated jeans outfit - Casual dress with sneakers - Button-down with sleeves rolled up ## Casual Don'ts - Avoid clothing that's too large or baggy - No stained or visibly worn items - Avoid overly revealing clothing in public settings - Don't mix too many bold patterns in one casual look`, formal_outfits: `# Formal Outfit Style Guide ## Black Tie Events - Women: Floor-length gown, elegant cocktail dress - Men: Tuxedo, formal black suit with bow tie - Accessories: Fine jewelry, formal watch, cufflinks - Shoes: Formal heels, patent leather shoes ## White Tie Events - Women: Ball gown, opera-length gloves - Men: Tailcoat, white bow tie, white waistcoat - Extremely formal and traditional ## Cocktail Attire - Women: Knee-length cocktail dress, dressy separates - Men: Dark suit with tie, dress shirt with slacks - More flexible than black tie but still elegant ## Business Formal - Women: Tailored suit, conservative dress with jacket - Men: Business suit with tie, polished dress shoes - Colors: Navy, charcoal, black, subtle patterns - Accessories: Minimal, high-quality, not distracting ## Semi-Formal - Women: Cocktail dress, dressy skirt and top - Men: Dark suit, no tie required, dress shirt - More relaxed than formal but still sophisticated ## Formal Do's & Don'ts ### Do's - Invest in proper tailoring - Choose high-quality fabrics - Keep accessories elegant and understated - Consider the venue and time of day (lighter colors for day events) ### Don'ts - Avoid casual fabrics (denim, cotton t-shirts) - Don't wear overly revealing styles for business or traditional events - Avoid wrinkled or ill-fitting garments - Don't over-accessorize formal looks`, seasonal: `# Seasonal Style Guide ## Spring/Summer ### Spring Transition - Lightweight layers: cardigans, light jackets, scarves - Begin incorporating brighter colors - Mix winter pieces with lighter items - Fabrics: Light wool, cotton, lighter denim ### Summer - Breathable fabrics: Linen, cotton, rayon - Lighter colors and pastels - Protection pieces: Wide-brimmed hats, lightweight long sleeves - Proper fit: Allow for airflow in hot weather ## Fall/Winter ### Fall Transition - Begin layering: Light jackets, cardigans, light scarves - Rich, warm colors: Burgundy, mustard, olive - Mix summer pieces with warmer layers - Ankle boots, closed-toe shoes ### Winter - Focus on warmth and layering - Base layers, insulating middle layers, protective outer layers - Fabrics: Wool, cashmere, down, heavy cotton, corduroy - Accessories: Scarves, gloves, hats, warm socks ## Resort Wear - Lightweight, packable pieces - Wrinkle-resistant fabrics - Multi-purpose items that dress up or down - Sun protection pieces: Hats, cover-ups, light layers ## Transitional Dressing Tips - Invest in layering pieces that work across seasons - Use accessories to transition outfits between seasons - Consider fabric weight rather than just style - Keep a few season-spanning neutral pieces in rotation ## Seasonal Color Palettes - Spring: Pastels, soft colors, light neutrals - Summer: Bright colors, white, nautical themes - Fall: Earth tones, jewel tones, warm neutrals - Winter: Deep colors, rich jewel tones, black and white`, }; // Get the appropriate style guide let styleGuideContent = styleGuides[category] || styleGuides.general; // Add occasion-specific advice if requested if (occasion) { const occasionFormatted = occasion.replace(/_/g, ' '); styleGuideContent += `\n\n## ${occasionFormatted.charAt(0).toUpperCase() + occasionFormatted.slice(1)} Specific Advice - Consider the venue and time of day - Think about appropriate level of formality - Choose colors that suit the occasion - Accessorize appropriately - Consider practical concerns (comfort, weather, activities)`; } // Add seasonal advice if requested if (fashion_season) { const seasonFormatted = fashion_season.replace(/_/g, ' '); styleGuideContent += `\n\n## ${seasonFormatted.charAt(0).toUpperCase() + seasonFormatted.slice(1)} Fashion Tips - Focus on seasonal appropriate fabrics - Incorporate seasonal color trends - Layer appropriately for the weather - Consider seasonal occasions and activities - Adapt basic style principles to seasonal needs`; } return { success: true, content: [{ type: "text", text: styleGuideContent }] }; }
• src/index.ts:211-232 (schema)

  Tool schema definition in the list of available tools, specifying the inputSchema with properties for category, occasion, and fashion_season.
  { name: "get_style_guide", description: "Get styling advice and tips for creating effective fashion recommendations", inputSchema: { type: "object", properties: { category: { type: "string", description: "Category of styling advice (e.g., 'color_theory', 'body_types', 'casual_outfits', 'formal_outfits', 'seasonal')", default: "general" }, occasion: { type: "string", description: "Specific occasion to get styling advice for (e.g., 'office', 'wedding', 'date_night', 'casual_friday')" }, fashion_season: { type: "string", description: "Fashion season to get styling advice for (e.g., 'spring_summer', 'fall_winter', 'resort', 'transition')" } } } },
• src/index.ts:475-488 (registration)

  Switch case in the CallToolRequestSchema handler that routes 'get_style_guide' tool calls to the handleGetStyleGuide function.
  case "get_style_guide": { try { const args = request.params.arguments as any; return handleGetStyleGuide(args); } catch (error) { logger.error(`Error getting style guide: ${error instanceof Error ? error.message : String(error)}`, error); return { error: { message: error instanceof Error ? error.message : 'Unknown error occurred while getting style guide', code: 'STYLE_GUIDE_ERROR' } }; } }