金大哥 - blue-perfumery-mcp-server MCP 详情

article

README

🚀 🌸 蓝色香水坊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 | 唯一标识符 | | name | 香水名称 | | brand | 品牌名称 | | price | 以里拉为单位的价格 | | ml | 毫升体积（可选） | | originalPrice | 原价（可选） | | gender | "male"（男士）、"female"（女士）或 "unisex"（中性） | | notes | 香调数组 | | description | 描述文本 | | ageRange | 推荐年龄范围（最小/最大） | | characteristics | 特征描述符数组 |

每个香水包含全面信息：

基本信息：ID、名称、品牌、价格、体积
香调详情：香调、特点、描述
受众信息：目标性别、推荐年龄范围
购买信息：直接的Shopier购物链接
价格信息：当前价格和原价对比

🔧 技术细节

服务器使用以下技术构建：

TypeScript
@modelcontextprotocol/sdk
Node.js

🤝 贡献指南

我们欢迎贡献！您可以通过以下方式提供帮助：

分叉仓库
创建功能分支：git checkout -b feature/amazing-feature
提交更改：git commit -m 'Add amazing feature'
推送到分支：git push origin feature/amazing-feature
打开拉取请求

贡献思路

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

🐛 问题反馈

发现了漏洞或有功能请求？请打开一个问题。

📄 许可证

本项目根据MIT许可证授权 - 有关详细信息，请参阅LICENSE文件。

🏢 关于蓝色香水坊

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

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

blue-perfumery-mcp-server