Blue Perfumery

Model Context Protocol (MCP) server that enables AI assistants like Claude to access Blue Perfumery's perfume database and product information.

What is MCP?

Model Context Protocol is an open standard that allows AI assistants to securely access external data sources and tools. This server provides Claude and other MCP-compatible assistants direct access to Blue Perfumery's product catalog.

Tech Stack

Technology	Version	Purpose
Node.js	18+	Runtime
TypeScript	5.3+	Type Safety
MCP SDK	0.5+	Protocol Implementation
MongoDB	-	Database
Mongoose	8.0+	ODM

Available Tools

Tool	Description
list_all_perfumes	Get all perfumes in the collection
get_perfume_by_id	Get a specific perfume by ID
search_perfumes	Search perfumes by name or brand
get_perfumes_by_category	Filter by category (men, women, niche)
get_purchase_link	Get Shopier purchase link for a perfume

Installation

# Install dependencies
npm install

# Create .env file
echo "MONGODB_URI=your-mongodb-uri" > .env

# Build
npm run build

# Run
npm start

Claude Desktop Integration

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "blue-perfumery": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "MONGODB_URI": "your-mongodb-connection-string"
      }
    }
  }
}

Project Structure

src/
├── index.ts          # MCP server entry point
├── config/
│   └── database.ts   # MongoDB connection
└── models/
    └── Product.ts    # Perfume model

Example Usage

Once configured, you can ask Claude:

• "What perfumes does Blue Perfumery have?"
• "Search for woody perfumes"
• "Show me men's fragrances"
• "Get the purchase link for [perfume name]"

Environment Variables

Variable	Description
MONGODB_URI	MongoDB connection string

Scripts

Command	Description
npm run dev	Development with tsx
npm run build	Compile TypeScript
npm start	Start server

License

MIT