K-Beauty MCP Server

A Model Context Protocol (MCP) server that provides comprehensive Korean Beauty (K-Beauty) information through real-time web search and curated knowledge.

Features

AI-Powered Skin Analysis

• Photo Upload Analysis: Upload your selfie for personalized skin analysis
• Zone-by-Zone Assessment: T-zone, cheeks, eye area, and mouth area analysis
• Smart Recommendations: AI-generated K-Beauty routine based on your skin
• Concern Matching: Targeted products for specific skin issues (acne, aging, dryness, etc.)

Real-Time Web Search Integration

• Live search for K-Beauty products, brands, and ingredients
• Latest reviews and product information
• Up-to-date pricing and availability
• Current trends and recommendations

Comprehensive Brand Database

• 58+ Major K-Beauty Brands: From luxury giants to indie darlings
• Luxury Tier: Sulwhasoo, Whoo, OHUI, Hera, IOPE, Sum37, Amorepacific
• Premium Brands: Laneige, Mamonde, Etude House, Innisfree, The Face Shop
• Effective/Indie: COSRX, Beauty of Joseon, Purito, Dear Klairs, Benton
• Emerging Stars: Round Lab, Anua, Haruharu Wonder, ABIB, Goodal
• Medical/Derma: Dr. Jart+, Medicube, Dr.G, Lab No.4
• Makeup Leaders: 3CE, Peripera, CLIO, ROM&ND, Espoir

Advanced Ingredient Analysis

• 48+ Key Ingredients: Traditional hanbang to modern innovations
• Traditional Korean: Ginseng, rice water, green tea, mugwort, bamboo
• K-Beauty Innovations: Snail mucin, bee venom, fermented ingredients
• Botanical Extracts: Centella asiatica, camellia, cherry blossom, lotus
• Active Compounds: Niacinamide, hyaluronic acid, ceramides, peptides
• Unique Minerals: Volcanic ash, Jeju minerals, sea salt, pearl powder

Complete Product Categories

• 43+ Product Types: Every K-Beauty category covered
• Basic Skincare: Cleansers, toners, essences, serums, moisturizers
• Treatment Products: Exfoliators, masks, spot treatments, anti-aging
• Makeup: BB/CC creams, cushions, lip tints, eyeshadows
• Body Care: Lotions, hand creams, body oils, scrubs

Personalized Skincare Routines

• Korean 10-step routine customization
• Skin type-specific recommendations (oily, dry, combination, sensitive)
• Age-appropriate anti-aging routines
• Seasonal skincare adjustments

Global Accessibility

• Multi-language Support: English and Korean
• Worldwide Availability: No API keys required
• Offline Capability: Works with curated knowledge base

Quick Start

Installation

# Clone or download to your desired location
cd /path/to/your/mcp/servers
git clone <your-repo-url> k-beauty-mcp
cd k-beauty-mcp

# Install dependencies
pip install -r requirements.txt

Claude Desktop Configuration

Add to your Claude Desktop config file (claude_desktop_config.json):

{
  "mcpServers": {
    "k-beauty": {
      "command": "python3",
      "args": ["/full/path/to/k-beauty-mcp/kbeauty_mcp.py"],
      "cwd": "/full/path/to/k-beauty-mcp"
    }
  }
}

macOS/Linux config location:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows config location:

%APPDATA%\Claude\claude_desktop_config.json

Quick Test

Restart Claude Desktop and try these queries:

"Tell me about COSRX snail essence"
"Recommend a K-Beauty routine for sensitive skin"
"What are the benefits of ginseng in skincare?"
"Compare Sulwhasoo vs Laneige products"

Available Tools

1. search_kbeauty_brands

Search and get information about K-Beauty brands

Input: Brand name or category
Output: Brand details, history, popular products

2. get_product_info

Get detailed product information

Input: Brand name, optional product name
Output: Product details, benefits, pricing, reviews

3. analyze_ingredients

Analyze skincare ingredients

Input: Ingredient name
Output: Benefits, safety, usage recommendations

4. recommend_routine

Get personalized skincare routines

Input: Skin type, concerns, routine type
Output: Step-by-step Korean skincare routine

5. compare_products

Compare multiple K-Beauty products

Input: List of products to compare
Output: Side-by-side comparison with pros/cons

6. analyze_skin_photo

AI-powered facial skin analysis with personalized recommendations

Input: Base64 encoded selfie image + optional additional concerns
Output: Zone-by-zone skin analysis + personalized K-Beauty routine

7. skin_concern_matcher

Match specific skin concerns to targeted K-Beauty products

Input: Skin concerns list + skin type + budget preference
Output: Targeted product recommendations for each concern

Example Interactions

Brand Discovery

User: "What's a good affordable K-Beauty brand for beginners?"
Assistant: [Searches and provides COSRX, Beauty of Joseon recommendations]

Product Research

User: "Tell me about Beauty of Joseon Glow Deep Serum"
Assistant: [Live search + curated info about ingredients, benefits, reviews]

Routine Building

User: "I have oily, acne-prone skin. What's a good Korean routine?"
Assistant: [Customized 7-step routine with specific product recommendations]

Ingredient Education

User: "Is snail mucin actually good for skin?"
Assistant: [Detailed analysis of snail secretion benefits, safety, best products]

AI Skin Analysis

User: [Uploads selfie] "Analyze my skin and recommend products"
Assistant: [Provides zone-by-zone analysis + personalized K-Beauty routine]

Targeted Concern Matching

User: "I have acne and sensitivity issues, budget-friendly options please"
Assistant: [Lists specific COSRX and Purito products for acne + sensitive skin]

What Makes This Special

Revolutionary AI Skin Analysis

• Upload & Analyze: Take a selfie and get instant skin analysis
• **Zone-Based Assess…