MCP server for Blue Perfumery - AI-powered perfume discovery and shopping
2 stars
TypeScript
Updated Oct 5, 2025
Documentation
Blue Perfumery MCP Server
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
bash
# Install dependencies
npm install
# Create .env file
echo "MONGODB_URI=your-mongodb-uri" > .env
# Build
npm run build
# Run
npm startClaude Desktop Integration
Add to your Claude Desktop config (claude_desktop_config.json):
json
{
"mcpServers": {
"blue-perfumery": {
"command": "node",
"args": ["/path/to/mcp-server/dist/index.js"],
"env": {
"MONGODB_URI": "your-mongodb-connection-string"
}
}
}
}Project Structure
code
src/
├── index.ts # MCP server entry point
├── config/
│ └── database.ts # MongoDB connection
└── models/
└── Product.ts # Perfume modelExample 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
Similar MCP
Based on tags & features
Trending MCP
Most active this week