blue-perfumery-mcp-server

MCP server for Blue Perfumery - AI-powered perfume discovery and shopping

2 stars TypeScriptAI & Machine Learning 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 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

code

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

Frequently asked questions

What is blue-perfumery-mcp-server?

blue-perfumery-mcp-server is MCP server for Blue Perfumery - AI-powered perfume discovery and shopping

How do I install blue-perfumery-mcp-server?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is blue-perfumery-mcp-server open source?

Yes — it is hosted on GitHub at https://github.com/recepgocmen/blue-perfumery-mcp-server and has 2 stars.

Related MCP tools

cherry-studio

🍒 Cherry Studio is a desktop client that supports for multiple LLM providers. Built for the Model Context Protocol to enhance AI capabilities.

35,025 TypeScript

agentanthropicassistant+6

librechat

Enhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini...

31,284 TypeScript

aianthropicartifacts+17

fastgpt

FastGPT is a knowledge-based platform built on the LLMs, offers a comprehensive suite of out-of-the-box capabilities such as data processing, RAG retrieval, ...

26,183 TypeScript

agentclaudedeepseek+7

composio

Composio equips your AI agents & LLMs with 100+ high-quality integrations via function calling for the Model Context Protocol. Enhance AI assistants with powerf

25,863 TypeScript

agentic-aiagentsai+14

repomix

📦 Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Lan...

19,761 TypeScript

aianthropicartificial-intelligence+17

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Ag...

18,776 TypeScript

ai-agentai-agent-toolsai-agents+10

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP