MCP 服务器

Blue Perfumery MCP Server

A Model Context Protocol server that provides AI assistants with access to Blue Perfumery's perfume collection data, enabling users to search, compare, and purchase fragrances through natural language interactions.

README

🌸 Blue Perfumery MCP Server

A Model Context Protocol (MCP) server that provides seamless access to the Blue Perfumery perfume collection data, enabling AI assistants to help users discover and purchase their perfect fragrance.

✨ Overview

This MCP server exposes comprehensive perfume data from the Blue Perfumery website, allowing Claude and other MCP-compatible AI assistants to:

🔍 Search through 50+ premium perfumes
💰 Compare prices and get purchase links
🎯 Filter by gender, brand, and characteristics
📝 Access detailed fragrance notes and descriptions
🛒 Direct integration with Shopier for purchases

🛠️ Features

The server provides the following powerful tools:

list_all_perfumes - Returns all perfumes in the collection with full details
get_perfume_by_id - Retrieves a specific perfume by its unique ID
search_perfumes - Intelligent search by perfume name or brand
get_perfumes_by_category - Filter by category (men's, women's, or niche)
get_purchase_link - Get direct Shopier purchase links for any perfume

Installation

Option 1: NPM Package (Recommended)

npm install -g @blueperfumery/mcp-server

Option 2: From Source

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

Usage

Using with Claude Desktop

Add the following to your Claude Desktop configuration file:

For NPM installation:

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

For source installation:

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

Configuration File Location

The Claude Desktop configuration file is located at:

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

After updating the configuration, restart Claude Desktop.

Data Structure

Each perfume object contains:

id: Unique identifier
name: Perfume name
brand: Brand name
price: Price in TL
ml: Volume in milliliters (optional)
originalPrice: Original price (optional)
gender: "male", "female", or "unisex"
notes: Array of scent notes
description: Description text
ageRange: Recommended age range (min/max)
characteristics: Array of characteristic descriptors

Example Usage

Once connected to an MCP client, you can use the tools like this:

// List all perfumes
list_all_perfumes()

// Get specific perfume
get_perfume_by_id({ id: "mfk-br540" })

// Search perfumes
search_perfumes({ query: "oud" })

// Get perfumes by category
get_perfumes_by_category({ category: "niche" })

// Get purchase link
get_purchase_link({ id: "mfk-br540" })