Blue Perfumery MCP Server

一个模型上下文协议（MCP）服务器，提供无缝访问Blue Perfumery香水收藏数据，使AI助手能够帮助用户发现并购买他们理想的香水。

概述

此MCP服务器提供了来自Blue Perfumery网站的全面香水数据，允许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后，您可以提出自然语言问题，例如：

• "展示我所有的Tom Ford香水"
• "我想找一款1000 TL以下的女性甜味东方香水"
• "给我Baccarat Rouge 540的购买链接"
• "告诉我你们收藏中最贵的香水是什么"
• "找到一种含有乌德和香草香调的香水"

🏗️ 数据结构

每种香水都包括全面的信息：

• 基本信息：ID、名称、品牌、价格、容量
• 香调详情：香调、特性、描述
• 人口统计：目标性别、年龄范围建议
• 购买：直接Shopier购物链接
• 定价：当前价格和原价比较

开发

该服务器构建于：

• TypeScript
• @modelcontextprotocol/sdk
• Node.js

贡献

我们欢迎贡献！以下是您如何帮助的方法：

1. 分叉仓库
2. 创建功能分支：git checkout -b feature/amazing-feature
3. 提交更改：git commit -m '添加精彩功能'
4. 推送到分支：git push origin feature/amazing-feature
5. 打开拉取请求

贡献想法

• 🆕 添加新的香水品牌和系列
• 🔧 改善搜索算法
• 🌍 添加国际化支持
• 📊 添加分析和使用指标
• 🎨 通过图像增强数据结构
• 🔗 集成其他电子商务平台

问题

发现错误或有功能请求？请打开一个问题。

许可证

该项目采用MIT许可证 - 查看LICENSE文件以获取详细信息。

关于Blue Perfumery

Blue Perfumery是一家高端香水零售商，提供奢侈和小众香水。访问Blue Perfumery探索我们的全部收藏。

---

为香水社区制作 ❤️