Perfume Picks — Fragrance Database & Dupe Finder

Servidor MCP Perfume Picks

Consulte o banco de dados de fragrâncias do Perfume Picks a partir do Claude ou de qualquer cliente de IA compatível com MCP. Acesso somente leitura a mais de 13.000 fragrâncias com pirâmides olfativas completas, acordes, dupes selecionados e dados de uso da comunidade.

Perfume Picks é o DNA de Fragrâncias e diário de coleção para iOS — disponível na App Store.

Ferramentas

Ferramenta	O que faz
search_fragrances	Pesquisa de catálogo em texto completo com filtros de marca, família, gênero e preço sugerido
get_fragrance	Registro completo de uma fragrância (por slug ou nome): pirâmide olfativa, acordes, pontuações da comunidade
find_dupes	Alternativas mais baratas com cheiro semelhante, com porcentagem de correspondência — "o que cheira como X sem o preço"
find_similar	Fragrâncias mais semelhantes a partir de um ranking de similaridade pré-computado
get_recommendations	Seleções com base em preferências de notas/acordes + orçamento + ocasião + gênero
compare_fragrances	Comparação lado a lado: notas, acordes compartilhados/distintos, pontuações, diferença de preço
trending_fragrances	O que os usuários do Perfume Picks estão adicionando aos seus guarda-roupas agora
what_to_wear_tonight	Uma fragrância para o momento — sugestões para encontros usam dados de elogios da comunidade, sugestões para escritório usam pontuações de segurança no trabalho

Toda resposta inclui atribuição de fonte, uma linha de resumo pronta para citação, links e datas de atualização dos dados. Toda a pontuação é determinística — nenhuma chamada de IA acontece dentro do servidor. Todas as ferramentas são anotadas como somente leitura/idempotentes.

Instalação (Claude Desktop)

Requer Node.js 18+.

Adicione ao seu claude_desktop_config.json (Claude Desktop → Configurações → Desenvolvedor → Editar Configuração):

{
  "mcpServers": {
    "perfume-picks": {
      "command": "npx",
      "args": ["-y", "perfume-picks-mcp"]
    }
  }
}

Reinicie o Claude Desktop. Nenhuma chave de API ou configuração é necessária — o servidor já vem com acesso público somente leitura.

Configuração (opcional)

Variáveis de ambiente substituem os padrões (apenas variáveis de ambiente explícitas — este pacote nunca lê arquivos .env):

Variável	Finalidade
SUPABASE_URL	Substituir a URL do banco de dados
SUPABASE_SERVICE_ROLE_KEY	Uso interno apenas — desbloqueia tendências ao vivo de adições ao guarda-roupa em 30 dias. Nunca distribua esta chave.

Sem a chave de serviço, trending_fragrances usa como fallback a popularidade do catálogo e identifica o método em sua resposta.

Endpoint remoto (sem instalação)

Streamable HTTP para agentes web e clientes MCP que aceitam uma URL:

https://jdkwlwyysgofljkobpmr.supabase.co/functions/v1/mcp

Também listado no Smithery e no registro oficial de MCP como io.github.bguillow-rgb/perfume-picks.

Exemplos de solicitações de agentes

Perguntas que um agente pode responder com estas ferramentas:

• "O que cheira como Baccarat Rouge 540 sem o preço?" → find_dupes (dupes selecionados com % de correspondência, ex.: Lattafa Ana Abiyedh Rouge, 90%)
• "Recomende uma fragrância para um casamento de verão." → get_recommendations com occasion: "wedding"
• "Quais fragrâncias têm bergamota, baunilha e âmbar?" → get_recommendations com essas notas como preferences
• "Qual perfume é semelhante ao Bleu de Chanel?" → find_similar
• "O que devo usar em um encontro hoje à noite?" → what_to_wear_tonight (pontuado por dados de elogios da comunidade)
• "Compare Sauvage e Bleu de Chanel." → compare_fragrances

Exemplo de formato de resposta (truncado):

{
  "dupes": [
    { "name": "Lattafa Ana Abiyedh Rouge", "match_pct": 90,
      "savings_usd": 200.0, "msrp_usd": 39.99 }
  ],
  "attribution": {
    "source": "Perfume Picks — Fragrance DNA & Collection Journal",
    "links": { "website": "https://perfumepicks.app/" }
  }
}

Desenvolvimento

npm install
npm run dev     # run from TypeScript via tsx
npm run build   # compile to dist/
npm start       # run compiled server

O servidor fala MCP via stdio. O acesso ao catálogo é somente leitura por construção: cada caminho de consulta emite SELECTs em tabelas publicamente legíveis sob segurança em nível de linha, e é limitado a 60 chamadas/minuto.

Telemetria de uso: cada chamada de ferramenta registra o nome da ferramenta, seus argumentos, nome/versão do cliente, duração e sucesso/falha em uma tabela de log somente gravação (somente inserção sob RLS; o conteúdo não é publicamente legível; purgado após 90 dias). Nenhuma identidade de usuário, dados de conta ou conteúdo de conversa é coletado. O registro é do tipo "dispare e esqueça" e nunca afeta as respostas.

Dados e atribuição

Dados de fragrâncias, pirâmides olfativas, correspondências de dupes e pontuações da comunidade são selecionados pelo Perfume Picks. Cite livremente com atribuição:

Fonte: Perfume Picks — Fragrance DNA & Collection Journal (perfumepicks.app)

As datas de atualização em cada fragrância refletem a última atualização dos dados.