# K-Beauty-MCP
## 基本信息
- Slug: `alexai-mcp-k-beauty-mcp`
- Source: modelscope
- Publisher: @AlexAI-MCP/K-Beauty-MCP
- Categories: search / health-and-wellness / image-and-video-processing
- Hosted: No
- License: Other
- Source URL: https://www.modelscope.cn/mcp/servers/@AlexAI-MCP/K-Beauty-MCP
## 简介
暂无描述。
## 安装提示

```bash
# 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
```

## MCP Server 详情

#  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

```bash
# 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`):

```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:**
```bash
~/Library/Application Support/Claude/claude_desktop_config.json
```

**Windows config location:**
```bash
%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…