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，帮助你结合传统知识和现代创新做出明智的护肤决策。

祝你探索韩国美妆之旅愉快！ 🌸✨