Blue Perfumery MCP Server

🚀 🌸 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.

🚀 Quick Start

This MCP server exposes comprehensive perfume data from the Blue Perfumery website, allowing Claude and other MCP-compatible AI assistants to interact with perfume data easily. You can install it via NPM or from the source code, and then configure it in Claude Desktop to start using.

✨ 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 Examples

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.

Basic 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" })

Real - World Usage Examples

Once connected to Claude Desktop, you can ask natural language questions like:

• "Show me all the Tom Ford perfumes you have"
• "I want a sweet, oriental perfume for women under 1000 TL"
• "Give me the purchase link for Baccarat Rouge 540"
• "What are the most expensive perfumes in your collection?"
• "Find me a perfume with oud and vanilla notes"

📚 Documentation

Data Structure

Each perfume object contains:

🔧 Technical Details

The server is built with:

• TypeScript
• @modelcontextprotocol/sdk
• Node.js

🤝 Contributing

We welcome contributions! Here's how you can help:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

Ideas for Contributions

• 🆕 Add new perfume brands and collections
• 🔧 Improve search algorithms
• 🌍 Add internationalization support
• 📊 Add analytics and usage metrics
• 🎨 Enhance data structure with images
• 🔗 Integrate with other e - commerce platforms

🐛 Issues

Found a bug or have a feature request? Please open an issue.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🏢 About Blue Perfumery

Blue Perfumery is a premium fragrance retailer offering luxury and niche perfumes. Visit Blue Perfumery to explore our full collection.

Made with ❤️ for the fragrance community