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

🏢 关于蓝色香水坊

蓝色香水坊是一家高级香水零售商，提供奢华和小众香水。访问蓝色香水坊探索我们的完整系列。

为香水爱好者社区用心打造 ❤️