# 10ML Perfume Finder

Подключает к агенту базу из 5 400+ ароматов и 285 нот: поиск похожих запахов, сравнение, подбор по случаю. Пригодится, если пишете про парфюмерию или собираете подборки.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: 10ml-com
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/10ml-com/perfume-finder-mcp
- Обновлён: 2026-10-20
- HTML: https://affpapa.org/nevibecode/mcp/10ml-perfume-finder

## Что делает

Сервер работает по Streamable HTTP на одном адресе `https://mcp.10ml.com/mcp`. Регистрация не нужна, ключей тоже нет, доступ только на чтение. Внутри 15 инструментов: `search_perfumes` ищет по названию, дому, нотам и аккордам, `get_perfume` отдаёт пирамиду нот и пять похожих ароматов, `compare_perfumes` ставит рядом от двух до четырёх запахов и показывает общие и различающиеся ноты.

Есть отдельные вызовы под житейские задачи: `find_gift` подбирает подарок, `suggest_layering` объясняет, что с чем сочетать, `pick_for_occasion` фильтрует по сезону и поводу. Плюс шесть готовых промптов вроде `find_signature_scent` и `build_fragrance_wardrobe`. Каждый инструмент принимает `locale` — ссылки и подписи приходят на одном из десяти языков, включая `ru`? Нет, русского в списке нет: `en`, `de`, `fr`, `es`, `it`, `ro`, `el`, `hu`, `cs`, `pl`.

Клиентам, которые запускают локальные программы, тот же сервер доступен через stdio: `npx -y @10ml/perfume-finder-mcp` (нужен Node.js 18+) или `uvx perfume-finder-mcp` (Python 3.10+). Старые имена `iconic_perfumes` и `trending_perfumes` ещё отвечают как алиасы, но в списке инструментов их больше нет — если интеграция завязана на них, лучше перейти на `search_perfumes` с `iconic: true`.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.10ml.com/mcp`

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcp
```

2. **Командой платформы**
```bash
claude mcp add 10ml-perfume-finder -- npx -y @10ml/perfume-finder-mcp
```

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add 10ml-perfume-finder --url https://mcp.10ml.com/mcp
```

2. **Командой платформы**
```bash
codex mcp add 10ml-perfume-finder -- npx -y @10ml/perfume-finder-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "10ml-perfume-finder": {
            "url": "https://mcp.10ml.com/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "10ml-perfume-finder": {
            "command": "npx",
            "args": [
                "-y",
                "@10ml/perfume-finder-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "10ml-perfume-finder": {
            "type": "http",
            "url": "https://mcp.10ml.com/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "10ml-perfume-finder": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@10ml/perfume-finder-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http 10ml-perfume-finder https://mcp.10ml.com/mcp
```

2. **Командой платформы**
```bash
gemini mcp add 10ml-perfume-finder npx -y @10ml/perfume-finder-mcp
```

## Когда брать
- найти аромат, похожий на любимый, но посвежее
- сравнить два парфюма по общим и разным нотам
- объяснить, чем пахнет амброксан и где он ведёт
- подобрать подарок по вкусам человека
- собрать идеи для наслаивания ванили и цитруса

## Примеры запросов агенту
- Подбери свежий летний аромат для офиса и объясни, почему каждый подходит
- Сравни два парфюма по пирамиде нот и скажи, что у них общего
- Что пахнет как Baccarat Rouge 540 и какая есть альтернатива у другого дома?

## Похожие
- [Scento Perfume API (MCP server)](https://affpapa.org/nevibecode/mcp/scento-perfume-api-mcp-server.md) — MCP-сервер
- [outlier-post-finder](https://affpapa.org/nevibecode/skills/outlier-post-finder.md) — скилл · 1300 установок
- [amazon-niche-finder](https://affpapa.org/nevibecode/skills/amazon-niche-finder.md) — скилл · 1300 установок
- [amazon-deal-finder](https://affpapa.org/nevibecode/skills/amazon-deal-finder.md) — скилл · 1100 установок
- [stock-photo-finder](https://affpapa.org/nevibecode/skills/stock-photo-finder.md) — скилл · 582 установки
- [lookalike-customer-finder](https://affpapa.org/nevibecode/skills/lookalike-customer-finder.md) — скилл · 324 установки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md