K Beauty MCP

🚀 🌸 K-Beauty MCP Server

このModel Context Protocol (MCP)サーバーは、リアルタイムのウェブ検索と精選された知識を通じて、包括的な韓国美容（K-Beauty）情報を提供します。

✨ 主な機能

📸 AIによる肌分析

• 写真アップロード分析：自撮り写真をアップロードし、個人化された肌分析を受けることができます。
• ゾーン別評価：Tゾーン、頬、目の周り、口の周りなどのゾーン別に分析されます。
• スマートなレコメンド：あなたの肌に合わせたAI生成のK-Beautyケアルーチンが提供されます。
• 問題マッチング：特定の肌の問題（ニキビ、老化、乾燥など）に対応したターゲット商品が提案されます。

🔍 リアルタイムウェブ検索統合

• K-Beautyの商品、ブランド、成分に関するライブ検索が可能です。
• 最新のレビューと商品情報を取得できます。
• 最新の価格と在庫状況を確認できます。
• 現在のトレンドとレコメンドを把握できます。

💄 包括的なブランドデータベース

• 58以上の主要K-Beautyブランド：高級ブランドからインディーブランドまで幅広くカバーされています。
  • 高級ブランド：雪花秀、後、オホイ、ヘラ、イオペ、サム37、アモレパシフィック
  • プレミアムブランド：ラネジュ、マモンド、エチュードハウス、イニスフリー、ザ・フェイスショップ
  • エフェクティブ/インディーブランド：コスリクス、ビューティーオブジョセオン、プリト、ディア・クレア、ベントン
  • 新興ブランド：ラウンドラボ、アヌア、ハルハルワンダー、アビブ、グッダル
  • 医療/デルマブランド：ディクサート、メディキューブ、ドクターG、ラボナンバー4
  • メイクアップリーダー：3CE、ペリペラ、クリオ、ロム&エヌディ、エスポワール

🧪 高度な成分分析

• 48以上の主要成分：伝統的な韓方薬から現代的な革新的成分まで幅広くカバーされています。
  • 伝統的な韓国成分：人参、米ぬか水、緑茶、ヨモギ、竹
  • K-Beautyの革新的成分：ナメクジムス、ハチ毒、発酵成分
  • 植物エキス：センチネラアシアティカ、ツバキ、桜、蓮
  • 活性化合物：ナイアシンアミド、ヒアルロン酸、セラミド、ペプチド
  • 独特なミネラル：火山灰、済州島のミネラル、海塩、真珠粉

📊 完全な商品カテゴリー

• 43以上の商品タイプ：あらゆるK-Beautyカテゴリーが網羅されています。
  • 基本的なスキンケア：クレンジング、化粧水、美容液、セラム、モイスチャライザー
  • トリートメント商品：エクスフォリエーター、マスク、スポットトリートメント、抗老化商品
  • メイクアップ：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 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を再起動し、以下のクエリを試してみましょう。

"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ブランドの情報を検索します。

入力: ブランド名またはカテゴリー
出力: ブランドの詳細、歴史、人気商品

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商品をマッチングします。

入力: 肌の問題のリスト + 肌タイプ + 予算の好み
出力: 各問題に対するターゲット商品のレコメンド

💡 サンプルの対話例

ブランド発見

ユーザー: "What's a good affordable K-Beauty brand for beginners?"
アシスタント: [COSRX、ビューティーオブジョセオンのレコメンドを検索して提供]

商品調査

ユーザー: "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"
アシスタント: [ゾーン別の肌分析 + 個人化されたK-Beautyルーチン]

🆕 ターゲット問題マッチング

ユーザー: "I have acne and sensitivity issues, budget-friendly options please"
アシスタント: [ニキビと敏感肌に適したCOSRXとプリトの特定の商品をリストアップ]

🌟 このサーバーの特徴

📸 革新的なAI肌分析

• アップロード&分析：自撮り写真を撮ってすぐに肌分析を受けることができます。
• ゾーンベースの評価：Tゾーン、頬、目などを別々に分析します。
• 個人化されたルーチン：あなたの肌に合わせたカスタムK-Beautyルーチンが提供されます。
• スマートな商品マッチング：AIが検出した問題に基づいて商品をマッチングします。

リアルタイム情報

• ライブウェブ検索：常に最新の商品情報とレビューを提供します。
• 58以上のブランド認識：主要なK-Beautyブランドからインディーブランドまで自動的に認識します。
• 最新の価格：地域を問わず最新の価格と在庫状況を提供します。
• トレンド追跡：現在世界的に人気のあるK-Beautyトレンドを把握できます。

無制限のブランドカバレッジ

• 制限なし：ハードコードされたデータベースとは異なり、あらゆるK-Beautyブランドを検索できます。
• 新興ブランド：新しいトレンドの韓国美容ブランドを発見できます。
• 地域ブランド：世界的には入手できない地元の韓国ブランドを見つけることができます。
• 完全なカバレッジ：高級コングロマリットから一人のインディーブランドまで幅広くカバーされています。

文化的なコンテキスト

• 伝統的な韓方薬：韓国の伝統医学成分が説明されています。
• 現代的な革新：韓国のブランドが世界のスキンケアを革新した方法が解説されています。
• 文化的な意義：K-Beautyの哲学を理解することができます。
• 歴史的な背景：伝統的な韓国の美容慣習とその進化が紹介されています。

実用的なガイダンス

• ステップバイステップのルーチン：明確で実行可能なスキンケアガイダンスが提供されます。
• 商品マッチング：一緒に使える商品を見つけることができます。
• 肌タイプ別：あなたのニーズに合わせたレコメンドが提供されます。

🔧 技術的詳細

アーキテクチャ

• 言語：Python 3.8以上
• フレームワーク：Model Context Protocol (MCP)
• 検索エンジン：DuckDuckGo API（APIキー不要）
• ブランドカバレッジ：58以上の主要K-Beautyブランドを無制限に検索可能
• 成分データベース：48以上の伝統的および現代的なK-Beauty成分
• 商品カテゴリー：43以上の完全なスキンケアとメイクアップカテゴリー
• 肌の問題：21以上のターゲット肌の問題カテゴリー

スマート認識システム

• 自動ブランド検出：58以上のK-Beautyブランドを自動的に認識します。
• コンテキスト強化：すべての検索に韓国美容のコンテキストを追加します。
• インテリジェントクエリ：K-Beautyの結果を改善するために検索用語を最適化します。
• 文化的統合：伝統的な韓国医学（韓方薬）のコンテキストを含みます。

依存関係

• mcp>=1.0.0 - Model Context Protocol
• aiohttp>=3.9.0 - ウェブ検索用の非同期HTTPクライアント
• beautifulsoup4>=4.12.0 - HTML解析（必要な場合）

AI肌分析

• コンピュータビジョン：現在はシミュレートされた分析（本番環境ではGoogle Vision AI、Azure Computer Visionを使用）
• ゾーン検出：Tゾーン、頬、目の周り、口の周りの分析
• 問題マッピング：ニキビ、老化、乾燥、敏感肌などの自動検出
• 商品マッチング：検出された問題に基づくAIによるレコメンド

パフォーマンス

• 応答時間：ほとんどのクエリで2秒未満
• オフラインモード：精選されたデータを使用してインターネットなしでも動作
• キャッシュに適している：一般的な検索結果を再利用します。

🤝 コントリビューション

これはオープンソースのK-Beauty知識プロジェクトです！コントリビューションを歓迎します。

1. ブランド情報：新しいK-Beautyブランドと商品を追加します。
2. 成分データベース：成分の知識ベースを拡張します。
3. 文化的コンテキスト：より多くの韓国美容の伝統と慣習を追加します。
4. 検索強化：ウェブ検索の精度と結果を改善します。

📝 ライセンス

MITライセンス - 自由に使用して改変してください！

🌸 K-Beautyについて

韓国美容（K-Beauty）は、以下の点で世界のスキンケア産業を革新しました。

• 革新性：グラススキン、美容液、クッションコンパクト
• 成分：ナメクジムス、人参、センチネラアシアティカ
• 哲学：治療よりも予防を重視し、温和で効果的
• アクセシビリティ：様々な価格帯で高品質の商品が提供されています。

このMCPサーバーは、K-Beautyの知恵をClaudeにもたらし、伝統的な知識と現代的な革新を組み合わせて、あなたが的確なスキンケアの決断を下せるように支援します。

Happy K-Beauty exploring! 🌸✨