shield_lock
JinDaGe
← Back to MCP directory
publicPublicdnsLocal runtime

k-beauty-mcp

一个提供韩妆(K-Beauty)信息的MCP服务器，支持实时搜索、品牌数据库、成分分析和AI皮肤照片分析，包含58+品牌和个性化护肤推荐。

article

README

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

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

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client