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桌面版配合使用

將以下內容添加到Claude桌面版配置文件中：

對於NPM安裝：

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

對於從源代碼安裝：

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

配置文件位置

Claude桌面版配置文件位於：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

更新配置後，重啟Claude桌面版。

基礎用法

連接到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桌面版後，您可以提出自然語言問題，例如：

• "給我看看你們所有的湯姆·福特香水"
• "我想要一款價格低於1000里拉的甜香型東方女士香水"
• "給我巴卡拉紅540的購買鏈接"
• "你們收藏中最貴的香水有哪些？"
• "幫我找一款帶有 oud 和香草香調的香水"

📚 詳細文檔

數據結構

每個香水對象包含：

每個香水包含全面信息：

• 基本信息：ID、名稱、品牌、價格、體積
• 香調詳情：香調、特點、描述
• 受眾信息：目標性別、推薦年齡範圍
• 購買信息：直接的Shopier購物鏈接
• 價格信息：當前價格和原價對比

🔧 技術細節

服務器使用以下技術構建：

• 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文件。

🏢 關於藍色香水坊

藍色香水坊是一家高級香水零售商，提供奢華和小眾香水。訪問藍色香水坊探索我們的完整系列。

為香水愛好者社區用心打造 ❤️