# 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