blue-perfumery-mcp-server

# 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](https://modelcontextprotocol.io/) 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 start ``` ## Claude 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 ``` 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