Skip to main content
Glama

K-Beauty MCP Server

by AlexLee-landscaper
GitHub
Python
3
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

🌸 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 Assessment: T-zone, cheeks, eyes analyzed separately

  • Personalized Routines: Custom K-Beauty routines based on your skin

  • Smart Product Matching: AI matches your concerns to specific products

Real-Time Information

  • Live Web Search: Always up-to-date product info and reviews

  • 58+ Brand Recognition: Automatically recognizes major to indie K-Beauty brands

  • Current Pricing: Latest prices and availability across regions

  • Trend Tracking: What's popular right now in K-Beauty globally

Unlimited Brand Coverage

  • No Restrictions: Unlike hardcoded databases, searches ANY K-Beauty brand

  • Emerging Brands: Discovers new and trending Korean beauty brands

  • Regional Brands: Finds local Korean brands not available globally

  • Complete Coverage: From luxury conglomerates to one-person indie brands

Cultural Context

  • Traditional Hanbang: Korean traditional medicine ingredients explained

  • Modern Innovation: How Korean brands revolutionized global skincare

  • Cultural Significance: Understanding the philosophy behind K-Beauty

  • Historical Background: Traditional Korean beauty practices and their evolution

Practical Guidance

  • Step-by-Step Routines: Clear, actionable skincare guidance

  • Product Matching: Find products that work together

  • Skin-Type Specific: Recommendations tailored to your needs

🔧 Technical Details

Architecture

  • Language: Python 3.8+

  • Framework: Model Context Protocol (MCP)

  • Search Engine: DuckDuckGo API (no API key required)

  • Brand Coverage: 58+ major K-Beauty brands with unlimited search

  • Ingredient Database: 48+ traditional and modern K-Beauty ingredients

  • Product Categories: 43+ complete skincare and makeup categories

  • Skin Concerns: 21+ targeted skin concern categories

Smart Recognition System

  • Auto-Brand Detection: Recognizes 58+ K-Beauty brands automatically

  • Context Enhancement: Adds Korean beauty context to all searches

  • Intelligent Queries: Optimizes search terms for better K-Beauty results

  • Cultural Integration: Includes traditional Korean medicine (hanbang) context

Dependencies

  • mcp>=1.0.0 - Model Context Protocol

  • aiohttp>=3.9.0 - Async HTTP client for web search

  • beautifulsoup4>=4.12.0 - HTML parsing (if needed)

AI Skin Analysis

  • Computer Vision: Currently simulated analysis (production would use Google Vision AI, Azure Computer Vision)

  • Zone Detection: T-zone, cheeks, eye area, mouth area analysis

  • Concern Mapping: Automatic detection of acne, aging, dryness, sensitivity

  • Product Matching: AI-powered recommendations based on detected issues

Performance

  • Response Time: <2 seconds for most queries

  • Offline Mode: Works without internet using curated data

  • Cache-Friendly: Reuses common search results

🤝 Contributing

This is an open-source K-Beauty knowledge project! Contributions welcome:

  1. Brand Information: Add new K-Beauty brands and products

  2. Ingredient Database: Expand the ingredient knowledge base

  3. Cultural Context: Add more Korean beauty traditions and practices

  4. Search Enhancement: Improve web search accuracy and results

📝 License

MIT License - Feel free to use and modify!

🌸 About K-Beauty

Korean Beauty (K-Beauty) has revolutionized the global skincare industry with:

  • Innovation: Glass skin, essences, cushion compacts

  • Ingredients: Snail mucin, ginseng, centella asiatica

  • Philosophy: Prevention over treatment, gentle yet effective

  • Accessibility: High-quality products at various price points

This MCP server brings the wisdom of K-Beauty to Claude, helping you make informed skincare decisions with both traditional knowledge and modern innovations.

Happy K-Beauty exploring! 🌸✨

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Provides comprehensive Korean Beauty information through real-time web search, AI-powered skin analysis from photos, and curated knowledge of 58+ K-Beauty brands, ingredients, and personalized skincare routines.

  1. ✨ Features
    1. 📸 AI-Powered Skin Analysis
    2. 🔍 Real-Time Web Search Integration
    3. 💄 Comprehensive Brand Database
    4. 🧪 Advanced Ingredient Analysis
    5. 📊 Complete Product Categories
    6. 💆‍♀️ Personalized Skincare Routines
    7. 🌍 Global Accessibility
  2. 🚀 Quick Start
    1. Installation
    2. Claude Desktop Configuration
    3. Quick Test
  3. 🛠️ Available Tools
    1. 1. search_kbeauty_brands
    2. 2. get_product_info
    3. 3. analyze_ingredients
    4. 4. recommend_routine
    5. 5. compare_products
    6. 6. analyze_skin_photo 🆕
    7. 7. skin_concern_matcher 🆕
  4. 💡 Example Interactions
    1. Brand Discovery
    2. Product Research
    3. Routine Building
    4. Ingredient Education
    5. 🆕 AI Skin Analysis
    6. 🆕 Targeted Concern Matching
  5. 🌟 What Makes This Special
    1. 📸 Revolutionary AI Skin Analysis
    2. Real-Time Information
    3. Unlimited Brand Coverage
    4. Cultural Context
    5. Practical Guidance
  6. 🔧 Technical Details
    1. Architecture
    2. Smart Recognition System
    3. Dependencies
    4. AI Skin Analysis
    5. Performance
  7. 🤝 Contributing
    1. 📝 License
      1. 🌸 About K-Beauty

        New MCP Servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/AlexLee-landscaper/K-Beauty-MCP'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server