K-Beauty MCP Server

🌸 K-Beauty MCP服务器

一种模型上下文协议（MCP）服务器，通过以下方式提供全面的韩国美容（K-Beauty）信息 实时网络搜索 以及精心策划的知识。

✨ 特性

📸 人工智能皮肤分析

• 照片上传分析：上传您的自拍以进行个性化皮肤分析
• 逐区评估：T区、脸颊、眼部和口腔区域分析
• 智能推荐：基于你的皮肤的人工智能生成K-Beauty程序
• 问题匹配：针对特定皮肤问题（痤疮、衰老、干燥等）的目标产品

🔍 实时Web搜索集成

• K-Beauty产品、品牌和成分的实时搜索
• 最新评论和产品信息
• 最新的定价和可用性
• 当前趋势和建议

💄 综合品牌数据库

• 58+主要K-Beauty品牌：从奢侈品巨头到独立宠儿
• 豪华级别： 雪花秀、Whoo、OHUI、赫拉、IOPE、Sum37、爱茉莉太平洋
• 高端品牌： 兰芝、马蒙德、练习曲屋、悦诗风吟、The Face Shop
• 有效/独立： COSRX，朝鲜之美，普里托，亲爱的Klairs，本顿
• 新兴明星： 圆形实验室、阿努阿、Haruharu Wonder、ABIB、Goodal
• 医疗/皮肤： Jart+博士，Medicube，G博士，4号实验室
• 化妆师： 3CE、Peripera、CLIO、ROM&ND、埃斯波

🧪 高级成分分析

• 48+关键成分：从传统汉邦到现代创新
• 传统韩语： 人参、米水、绿茶、艾草、竹子
• K-Beauty创新： 蜗牛粘蛋白、蜂毒、发酵成分
• 植物提取物： 积雪草、山茶花、樱花、荷花
• 活性化合物： 烟酰胺、透明质酸、神经酰胺、多肽
• 独特矿物： 火山灰、济州矿物、海盐、珍珠粉

📊 完整的产品类别

• 43+产品类型：涵盖所有K-Beauty类别
• 基础护肤： 洁面乳、爽肤水、香精、精华、保湿霜
• 治疗产品： 去角质、面膜、斑点护理、抗衰老
• 化妆： BB/CC面霜、靠垫、唇彩、眼影
• 身体护理： 乳液、护手霜、身体油、磨砂膏

💆‍♀️ 个性化护肤程序

• 韩国10步常规定制
• 针对特定皮肤类型的建议（油性、干性、混合性、敏感性）
• 适合年龄的抗衰老常规
• 季节性护肤调整

🌍 全球可及性

• 多语言支持： 英语和韩语
• 全球可用性： 不需要API密钥
• 离线能力： 使用精心策划的知识库

🚀 快速开始

安装

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

# Install dependencies
pip install -r requirements.txt

Claude桌面配置

添加到您的Claude Desktop配置文件(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 Desktop并尝试以下查询：

"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

搜索并获取K-Beauty品牌信息

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

2. get_product_info

获取详细的产品信息

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

3. analyze_ingredients

分析护肤成分

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

4. recommend_routine

获得个性化的护肤程序

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

5. compare_products

比较多种K-Beauty产品

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

6. analyze_skin_photo 🆕

基于人工智能的面部皮肤分析，提供个性化建议

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

7. skin_concern_matcher 🆕

将特定的皮肤问题与目标K-Beauty产品相匹配

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

💡 交互示例

品牌发现

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

产品研究

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

常规建筑

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

成分教育

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

🆕 AI皮肤分析

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

🆕 有针对性的问题匹配

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

🌟 是什么让这个特别

📸 革命性的AI皮肤分析

• 上传和分析：自拍并立即进行皮肤分析
• 基于区域的评估：T区、脸颊、眼睛分别分析
• 个性化例程：根据您的皮肤定制K-Beauty程序
• 智能产品匹配：AI将您的关注点与特定产品相匹配

实时信息

• 实时网络搜索： 始终保持最新的产品信息和评论
• 58+品牌认知度： 自动识别主要到独立的K-Beauty品牌
• 当前定价： 各地区的最新价格和可用性
• 趋势跟踪： 目前K-Beauty在全球范围内流行什么

无限品牌覆盖

• 无限制： 与硬编码数据库不同，搜索任何K-Beauty品牌
• 新兴品牌： 发现新的和流行的韩国美容品牌
• 区域品牌： 查找全球无法买到的韩国本土品牌
• 全面覆盖： 从奢侈品集团到单人独立品牌

文化语境

• 传统汉邦： 韩国传统药物成分详解
• 现代创新： 韩国品牌如何彻底改变全球护肤
• 文化意义： 了解K-Beauty背后的哲学
• 历史背景： 韩国传统美容实践及其演变

实用指南

• 循序渐进的程序： 清晰、可操作的护肤指南
• 产品匹配： 寻找协同工作的产品
• 特定皮肤类型： 根据您的需求量身定制的建议

🔧 技术细节

建筑

• 语言： Python 3.8+
• 框架： 模型上下文协议（MCP）
• 搜索引擎： DuckDuckGo API（不需要API密钥）
• 品牌覆盖范围： 58多个K-Beauty主要品牌，无限制搜索
• 成分数据库： 48+传统和现代K-Beauty成分
• 产品分类： 43+完整的护肤和化妆类别
• 皮肤问题： 21+针对性皮肤问题类别

智能识别系统

• 汽车品牌检测： 自动识别58+K-Beauty品牌
• 上下文增强： 将韩国美女背景添加到所有搜索中
• 智能查询： 优化搜索词以获得更好的K-Beauty结果
• 文化融合： 包括韩国传统医学（汉邦）背景

依赖项

• mcp>=1.0.0 -模型上下文协议
• aiohttp>=3.9.0 -用于web搜索的异步HTTP客户端
• beautifulsoup4>=4.12.0 -HTML解析（如果需要）

AI皮肤分析

• 计算机视觉：目前模拟分析（生产将使用谷歌视觉AI、Azure计算机视觉）
• 区域检测：T区、脸颊、眼部区域、嘴部区域分析
• 关注点映射：自动检测痤疮、衰老、干燥、敏感性
• 产品匹配：基于检测到的问题的人工智能推荐

演出

• 响应时间： 对于大多数查询，\<2秒
• 离线模式： 使用精选数据在没有互联网的情况下工作
• 缓存友好： 重复使用常见搜索结果

🤝 贡献

这是一个开源的K-Beauty知识项目！欢迎捐款：

1. 品牌信息： 添加新的K-Beauty品牌和产品
2. 成分数据库： 扩展成分知识库
3. 文化背景： 添加更多韩国美容传统和做法
4. 搜索增强： 提高网络搜索的准确性和结果

📝 许可证

MIT许可证-随意使用和修改！

🌸 关于K-Beauty

韩国美容（K-Beauty）通过以下方式彻底改变了全球护肤行业：

• 创新： 玻璃皮、香精、缓冲压块
• 成分： 蜗牛粘蛋白、人参、积雪草
• 哲学： 预防胜于治疗，温和而有效
• 可访问性： 各种价位的高品质产品

这款MCP服务器将K-Beauty的智慧带给克劳德，帮助您利用传统知识和现代创新做出明智的护肤决策。

______________________________________________________________________

快乐K-Beauty探索！ 🌸✨