K美妆-MCP
项目介绍
🌸 韩国美妆 MCP 服务器
这是一个通过实时网络搜索和精选知识提供全面韩国美妆（K-Beauty）信息的模型上下文协议（MCP）服务器。
✨ 特性
📸 AI驱动的皮肤分析
- 照片上传分析：上传自拍照进行个性化皮肤分析
- 分区评估：T区、脸颊、眼周和唇部区域分析
- 智能推荐：基于您的皮肤生成AI生成的K-Beauty日常护理方案
- 问题匹配：针对特定皮肤问题（如痤疮、衰老、干燥等）的产品
🔍 实时网络搜索集成
- 实时搜索K-Beauty产品、品牌和成分
- 最新评论和产品信息
- 最新的价格和可用性
- 当前趋势和推荐
💄 全面的品牌数据库
- 58+ 主要K-Beauty品牌：从奢侈巨头到独立品牌
- 奢侈级：Sulwhasoo, Whoo, OHUI, Hera, IOPE, Sum37, Amorepacific
- 高级品牌：Laneige, Mamonde, Etude House, Innisfree, The Face Shop
- 有效/独立：COSRX, Beauty of Joseon, Purito, Dear Klairs, Benton
- 新兴明星：Round Lab, Anua, Haruharu Wonder, ABIB, Goodal
- 医学/药妆：Dr. Jart+, Medicube, Dr.G, Lab No.4
- 彩妆领导者：3CE, Peripera, CLIO, ROM&ND, Espoir
🧪 先进的成分分析
- 48+ 关键成分：从传统韩方到现代创新
- 传统韩国：人参、米水、绿茶、艾草、竹子
- K-Beauty创新：蜗牛粘液、蜂毒、发酵成分
- 植物提取物：亚洲人参、山茶花、樱花、莲花
- 活性化合物：烟酰胺、透明质酸、神经酰胺、肽
- 独特矿物质：火山灰、济州岛矿物质、海盐、珍珠粉
📊 完整的品类覆盖
- 43+ 产品类型：涵盖所有K-Beauty类别
- 基础护肤：洁面乳、爽肤水、精华液、精华素、保湿霜
- 治疗产品：去角质、面膜、局部治疗、抗衰老
- 彩妆：BB/CC霜、气垫粉底、唇彩、眼影
- 身体护理：润肤露、护手霜、身体油、磨砂膏
💆♀️ 个性化的护肤程序
- 韩式十步护肤程序定制
- 根据皮肤类型（油性、干性、混合性、敏感性）的建议
- 适合年龄的抗衰老程序
- 季节性护肤调整
🌍 全球可访问性
- 多语言支持：英语和韩语
- 全球可用性：无需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 Desktop 配置
添加到您的 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 并尝试以下查询：
"告诉我关于 COSRX 蜗牛精华"
"推荐一个适合敏感肌肤的 K-Beauty 护肤程序"
"人参在护肤中的好处是什么？"
"比较 Sulwhasoo 和 Laneige 的产品"
🛠️ 可用工具
1. search_kbeauty_brands
搜索并获取 K-Beauty 品牌的信息
输入：品牌名称或类别
输出：品牌详情、历史、热门产品
2. get_product_info
获取详细的产品信息
输入：品牌名称，可选产品名称
输出：产品详情、益处、定价、评论
3. analyze_ingredients
分析护肤品成分
输入：成分名称
输出：益处、安全性、使用建议
4. recommend_routine
获取个性化的护肤程序
输入：皮肤类型、关注点、程序类型
输出：分步骤的韩式护肤程序
5. compare_products
比较多个 K-Beauty 产品
输入：要比较的产品列表
输出：并排比较，包括优缺点
6. analyze_skin_photo 🆕
AI驱动的面部皮肤分析与个性化建议
输入：Base64 编码的自拍照 + 可选额外关注点
输出：分区皮肤分析 + 个性化的 K-Beauty 程序
7. skin_concern_matcher 🆕
匹配特定皮肤问题到目标 K-Beauty 产品
输入：皮肤问题列表 + 皮肤类型 + 预算偏好
输出：针对每个问题的目标产品推荐
💡 示例交互
品牌发现
用户："对于初学者来说，有什么好的实惠的 K-Beauty 品牌？"
助手：[搜索并提供 COSRX、Joseon 美容的推荐]
产品研究
用户："告诉我关于 Joseon 美容 Glow Deep Serum"
助手：[实时搜索 + 精选信息关于成分、益处、评论]
程序构建
用户："我有油性和易长痘的皮肤。一个好的韩国程序是什么？"
助手：[定制的7步程序，附带具体的产品推荐]
成分教育
用户："蜗牛粘液对皮肤真的好吗？"
助手：[详细的蜗牛分泌物益处、安全性和最佳产品的分析]
🆕 AI 皮肤分析
用户：[上传自拍照]"分析我的皮肤并推荐产品"
助手：[提供分区分析 + 个性化的 K-Beauty 程序]
🆕 目标问题匹配
用户："我有痤疮和敏感性问题，请推荐预算友好的选项"
助手：[列出具体的 COSRX 和 Purito 产品，针对痤疮和敏感性皮肤]
🌟 这些特别之处
📸 革命性的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- 异步HTTP客户端用于网络搜索beautifulsoup4>=4.12.0- HTML解析（如有需要）
AI 皮肤分析
- 计算机视觉：目前模拟分析（生产中会使用Google Vision AI、Azure计算机视觉）
- 区域检测：T区、脸颊、眼周、唇部区域分析
- 问题映射：自动检测痤疮、衰老、干燥、敏感性
- 产品匹配：基于检测到的问题的AI驱动推荐
性能
- 响应时间：大多数查询小于2秒
- 离线模式：使用精选数据工作，无需互联网
- 缓存友好：重用常见搜索结果
🤝 贡献
这是一个开放源代码的K-Beauty知识项目！欢迎贡献：
- 品牌信息：添加新的K-Beauty品牌和产品
- 成分数据库：扩展成分知识库
- 文化背景：增加更多的韩国美容传统和实践
- 搜索改进：提高网络搜索的准确性和结果
📝 许可证
MIT 许可证 - 随意使用和修改！
🌸 关于 K-Beauty
韩国美妆（K-Beauty）以其创新改变了全球护肤行业：
- 创新：玻璃肌、精华液、气垫粉底
- 成分：蜗牛粘液、人参、亚洲人参
- 理念：预防胜于治疗，温和而有效
- 可访问性：各种价位的高质量产品
这个MCP服务器将K-Beauty的智慧带到Claude，帮助您做出明智的护肤决策，结合传统知识和现代创新。
愉快地探索K-Beauty吧！ 🌸✨