MCP Server
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.
2
GitHub Stars
3/2/2026
Last Updated
MCP Server Configuration
1{
2 "name": "blue-perfumery",
3 "command": "node",
4 "args": [
5 "/path/to/mcp-server/dist/index.js"
6 ],
7 "env": {
8 "MONGODB_URI": "your-mongodb-connection-string"
9 }
10}
JSON10 lines
README 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
# 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
Quick Install
Quick Actions
Key Features
Model Context Protocol
Secure Communication
Real-time Updates
Open Source