Blue Perfumery MCP Server

🚀 🌸 ブルーパーフューメリーMCPサーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を用いて、ブルーパーフューメリーの香水コレクションデータにシームレスにアクセスできるようにします。AIアシスタントがユーザーに最適な香水を見つけ、購入するのを支援できるようになります。

🚀 クイックスタート

このMCPサーバーは、ブルーパーフューメリーのウェブサイトから包括的な香水データを公開しています。Claudeや他のMCP互換のAIアシスタントが以下のことができるようになります。

• 🔍 50種類以上の高級香水を検索する
• 💰 価格を比較し、購入リンクを取得する
• 🎯 性別、ブランド、特徴でフィルタリングする
• 📝 詳細な香りノートと説明にアクセスする
• 🛒 Shopierと直接統合して購入する

✨ 主な機能

このサーバーは、以下の強力なツールを提供します。

• list_all_perfumes - コレクション内のすべての香水の詳細を返す
• get_perfume_by_id - 一意のIDで特定の香水を取得する
• search_perfumes - 香水名またはブランドでインテリジェントに検索する
• get_perfumes_by_category - カテゴリ（男性用、女性用、またはニッチ）でフィルタリングする
• get_purchase_link - 任意の香水のShopierの直接購入リンクを取得する

📦 インストール

オプション1: NPMパッケージ（推奨）

npm install -g @blueperfumery/mcp-server

オプション2: ソースから

git clone https://github.com/blueperfumery/mcp-server.git
cd mcp-server
npm install
npm run build

💻 使用例

Claude Desktopでの使用

Claude Desktopの設定ファイルに以下を追加します。 NPMインストールの場合:

{
  "mcpServers": {
    "blue-perfumery": {
      "command": "blue-perfumery-mcp"
    }
  }
}

ソースからインストールした場合:

{
  "mcpServers": {
    "blue-perfumery": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/mcp-server"
    }
  }
}

設定ファイルの場所

Claude Desktopの設定ファイルは以下の場所にあります。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json 設定を更新した後、Claude Desktopを再起動します。

📚 ドキュメント

データ構造

各香水オブジェクトには以下が含まれます。

• id: 一意の識別子
• name: 香水名
• brand: ブランド名
• price: 価格（TL）
• ml: ミリリットル単位の容量（オプション）
• originalPrice: 元の価格（オプション）
• gender: "male", "female", または "unisex"
• notes: 香りノートの配列
• description: 説明文
• ageRange: 推奨年齢範囲（最小/最大）
• characteristics: 特徴記述子の配列

基本的な使用法

MCPクライアントに接続したら、以下のようにツールを使用できます。

// すべての香水をリストする
list_all_perfumes()

// 特定の香水を取得する
get_perfume_by_id({ id: "mfk-br540" })

// 香水を検索する
search_perfumes({ query: "oud" })

// カテゴリで香水を取得する
get_perfumes_by_category({ category: "niche" })

// 購入リンクを取得する
get_purchase_link({ id: "mfk-br540" })

高度な使用法

Claude Desktopに接続したら、以下のような自然言語の質問をすることができます。

• "あなたが持っているすべてのトム・フォードの香水を見せて"
• "私は1000TL以下の甘いオリエンタルな女性用香水が欲しい"
• "バカラ・ルージュ540の購入リンクを教えて"
• "あなたのコレクションの中で最も高価な香水は何ですか？"
• "オードとバニラのノートがある香水を探して"

🔧 技術詳細

このサーバーは以下を使用して構築されています。

• TypeScript
• @modelcontextprotocol/sdk
• Node.js

🤝 コントリビューション

コントリビューションを歓迎します！以下の手順で支援できます。

1. リポジトリをフォークする
2. 機能ブランチを作成する: git checkout -b feature/amazing-feature
3. 変更をコミットする: git commit -m 'Add amazing feature'
4. ブランチにプッシュする: git push origin feature/amazing-feature
5. プルリクエストを開く

コントリビューションのアイデア

• 🆕 新しい香水ブランドとコレクションを追加する
• 🔧 検索アルゴリズムを改善する
• 🌍 国際化サポートを追加する
• 📊 分析と使用メトリクスを追加する
• 🎨 画像でデータ構造を強化する
• 🔗 他の電子商取引プラットフォームと統合する

🐛 問題の報告

バグを見つけた場合や機能要求がある場合は、問題を報告 してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。

🏢 ブルーパーフューメリーについて

ブルーパーフューメリーは、高級なニッチ香水を提供する高級香水小売店です。ブルーパーフューメリー を訪問して、全コレクションを探索してください。

香りのコミュニティのために愛を込めて作られました