K Beauty MCP

🚀 🌸 K-Beauty MCP 服務器

這是一個模型上下文協議（MCP）服務器，它通過即時網絡搜索和精心整理的知識，提供全面的韓國美妝（K - Beauty）信息。

✨ 主要特性

📸 AI 皮膚分析

• 照片上傳分析：上傳自拍照，獲取個性化皮膚分析。
• 分區評估：對 T 區、臉頰、眼部和嘴部區域進行分析。
• 智能推薦：基於你的皮膚狀況，由 AI 生成韓國美妝護膚流程。
• 問題匹配：針對特定皮膚問題（如痤瘡、衰老、乾燥等）推薦產品。

🔍 即時網絡搜索集成

• 即時搜索韓國美妝產品、品牌和成分。
• 獲取最新的產品評價和信息。
• 瞭解最新的價格和產品庫存情況。
• 掌握當前的流行趨勢和推薦。

💄 全面的品牌數據庫

• 58 + 個主要韓國美妝品牌：涵蓋從奢侈品牌到獨立小眾品牌。
  • 奢侈品牌：雪花秀、後、歐蕙、赫拉、伊蒂之屋、蘇秘 37°、愛茉莉太平洋。
  • 高端品牌：蘭芝、夢妝、悅木之源、悅詩風吟、菲詩小鋪。
  • 高效/獨立品牌：珂潤、自然堂、珀蒂詩、可萊絲、本汀。
  • 新興品牌：圓木實驗室、安熱沙、哈露哈露、艾蓓伊、古朵。
  • 醫學/皮膚科品牌：蒂佳婷、美迪惠爾、皮膚科醫生、四號實驗室。
  • 彩妝領導品牌：3CE、菲麗菲拉、珂萊歐、羅姆與諾德、艾絲珀。

🧪 高級成分分析

• 48 + 種關鍵成分：從傳統韓方草藥到現代創新成分。
  • 傳統韓國成分：人參、淘米水、綠茶、艾草、竹子。
  • 韓國美妝創新成分：蝸牛黏液、蜂毒、發酵成分。
  • 植物提取物：積雪草、山茶花、櫻花、蓮花。
  • 活性化合物：煙酰胺、透明質酸、神經酰胺、肽。
  • 獨特礦物質：火山灰、濟州島礦物質、海鹽、珍珠粉。

📊 完整的產品類別

• 43 + 種產品類型：涵蓋所有韓國美妝類別。
  • 基礎護膚品：潔面產品、爽膚水、精華液、乳液、面霜。
  • 護理產品：去角質產品、面膜、局部治療產品、抗皺產品。
  • 彩妝：BB/CC 霜、氣墊粉餅、唇彩、眼影。
  • 身體護理：乳液、護手霜、身體油、磨砂膏。

💆‍♀️ 個性化護膚流程

• 定製韓國 10 步護膚流程。
• 根據皮膚類型（油性、乾性、混合性、敏感性）提供特定建議。
• 提供適合不同年齡段的抗皺護膚流程。
• 根據季節調整護膚方案。

🌍 全球可用性

• 多語言支持：英語和韓語。
• 全球可用：無需 API 密鑰。
• 離線功能：可使用精心整理的知識庫。

🚀 快速開始

安裝

# 克隆或下載到你想要的位置
cd /path/to/your/mcp/servers
git clone <your-repo-url> k-beauty-mcp
cd k-beauty-mcp

# 安裝依賴
pip install -r requirements.txt

Claude 桌面配置

將以下內容添加到你的 Claude 桌面配置文件（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 配置文件位置：

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

Windows 配置文件位置：

%APPDATA%\Claude\claude_desktop_config.json

快速測試

重啟 Claude 桌面應用程序，然後嘗試以下查詢：

"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"

🛠️ 可用工具

1. search_kbeauty_brands

搜索並獲取韓國美妝品牌信息

輸入：品牌名稱或類別
輸出：品牌詳情、歷史、熱門產品

2. get_product_info

獲取詳細的產品信息

輸入：品牌名稱，可選的產品名稱
輸出：產品詳情、功效、價格、評價

3. analyze_ingredients

分析護膚品成分

輸入：成分名稱
輸出：功效、安全性、使用建議

4. recommend_routine

獲取個性化護膚流程

輸入：皮膚類型、皮膚問題、護膚流程類型
輸出：分步的韓國護膚流程

5. compare_products

比較多個韓國美妝產品

輸入：要比較的產品列表
輸出：產品優缺點的並排比較

6. analyze_skin_photo 🆕

基於 AI 的面部皮膚分析和個性化推薦

輸入：Base64 編碼的自拍照 + 可選的額外皮膚問題
輸出：分區皮膚分析 + 個性化韓國美妝護膚流程

7. skin_concern_matcher 🆕

將特定皮膚問題與針對性的韓國美妝產品匹配

輸入：皮膚問題列表 + 皮膚類型 + 預算偏好
輸出：針對每個問題的產品推薦

💡 示例交互

品牌發現

用戶："What's a good affordable K-Beauty brand for beginners?"
助手：[搜索並推薦珂潤、自然堂]

產品研究

用戶："Tell me about Beauty of Joseon Glow Deep Serum"
助手：[即時搜索 + 關於成分、功效、評價的整理信息]

護膚流程構建

用戶："I have oily, acne-prone skin. What's a good Korean routine?"
助手：[定製的 7 步護膚流程，包含具體產品推薦]

成分教育

用戶："Is snail mucin actually good for skin?"
助手：[詳細分析蝸牛黏液的功效、安全性、最佳產品]

🆕 AI 皮膚分析

用戶：[上傳自拍照] "Analyze my skin and recommend products"
助手：[提供分區分析 + 個性化韓國美妝護膚流程]

🆕 針對性問題匹配

用戶："I have acne and sensitivity issues, budget-friendly options please"
助手：[列出針對痤瘡和敏感皮膚的珂潤和珀蒂詩產品]

🌟 獨特之處

📸 革命性的 AI 皮膚分析

• 上傳與分析：自拍即可立即獲得皮膚分析。
• 分區評估：分別分析 T 區、臉頰、眼部。
• 個性化流程：根據你的皮膚狀況定製韓國美妝護膚流程。
• 智能產品匹配：AI 將你的皮膚問題與特定產品匹配。

即時信息

• 即時網絡搜索：始終提供最新的產品信息和評價。
• 58 + 品牌識別：自動識別主要到小眾的韓國美妝品牌。
• 最新價格：各地區的最新價格和庫存情況。
• 趨勢跟蹤：全球韓國美妝的當前流行趨勢。

無限品牌覆蓋

• 無限制：與硬編碼數據庫不同，可搜索任何韓國美妝品牌。
• 新興品牌：發現新的熱門韓國美妝品牌。
• 地區品牌：找到全球未上市的韓國本地品牌。
• 全面覆蓋：從奢侈集團到個人獨立品牌。

文化背景

• 傳統韓方草藥：解釋韓國傳統醫學成分。
• 現代創新：韓國品牌如何革新全球護膚行業。
• 文化意義：理解韓國美妝背後的哲學。
• 歷史背景：傳統韓國美容實踐及其演變。

實用指導

• 分步流程：清晰、可操作的護膚指導。
• 產品匹配：找到搭配使用的產品。
• 針對皮膚類型：根據你的需求提供推薦。

🔧 技術細節

架構

• 語言：Python 3.8 +
• 框架：模型上下文協議（MCP）
• 搜索引擎：DuckDuckGo API（無需 API 密鑰）
• 品牌覆蓋：58 + 個主要韓國美妝品牌，可進行無限搜索。
• 成分數據庫：48 + 種傳統和現代韓國美妝成分。
• 產品類別：43 + 種完整的護膚和彩妝類別。
• 皮膚問題：21 + 種針對性的皮膚問題類別。

智能識別系統

• 自動品牌檢測：自動識別 58 + 個韓國美妝品牌。
• 上下文增強：為所有搜索添加韓國美妝背景信息。
• 智能查詢：優化搜索詞以獲得更好的韓國美妝搜索結果。
• 文化融合：包含傳統韓國醫學（韓方草藥）背景信息。

依賴項

• mcp>=1.0.0 - 模型上下文協議
• aiohttp>=3.9.0 - 用於網絡搜索的異步 HTTP 客戶端
• beautifulsoup4>=4.12.0 - HTML 解析（如有需要）

AI 皮膚分析

• 計算機視覺：目前為模擬分析（生產環境將使用 Google Vision AI、Azure Computer Vision）
• 分區檢測：分析 T 區、臉頰、眼部、嘴部區域。
• 問題映射：自動檢測痤瘡、衰老、乾燥、敏感等問題。
• 產品匹配：基於檢測到的問題提供 AI 推薦。

性能

• 響應時間：大多數查詢響應時間小於 2 秒。
• 離線模式：可使用整理的數據在無網絡情況下工作。
• 緩存友好：重用常見搜索結果。

🤝 貢獻

這是一個開源的韓國美妝知識項目！歡迎貢獻：

1. 品牌信息：添加新的韓國美妝品牌和產品。
2. 成分數據庫：擴展成分知識庫。
3. 文化背景：添加更多韓國美容傳統和實踐。
4. 搜索增強：提高網絡搜索的準確性和結果。

📝 許可證

採用 MIT 許可證 - 可自由使用和修改！

🌸 關於韓國美妝

韓國美妝（K - Beauty）通過以下方面革新了全球護膚行業：

• 創新：玻璃肌、精華液、氣墊粉餅。
• 成分：蝸牛黏液、人參、積雪草。
• 理念：預防勝於治療，溫和而有效。
• 可及性：不同價格段的高品質產品。

這個 MCP 服務器將韓國美妝的智慧引入 Claude，幫助你結合傳統知識和現代創新做出明智的護膚決策。

祝你探索韓國美妝之旅愉快！ 🌸✨