Perfume Picks — Fragrance Database & Dupe Finder

Perfume Picks MCP Server

Consulta la base de datos de fragancias de Perfume Picks desde Claude, o cualquier cliente de IA compatible con MCP. Acceso de solo lectura a más de 13.000 fragancias con pirámides de notas completas, acordes, duplicados seleccionados y datos de uso de la comunidad.

Perfume Picks es el diario de ADN de fragancias y colección para iOS — disponible en la App Store.

Herramientas

Herramienta	Qué hace
search_fragrances	Búsqueda de texto completo en el catálogo con filtros de marca, familia, género y precio sugerido
get_fragrance	Registro completo de una fragancia (por slug o nombre): pirámide de notas, acordes, puntuaciones de la comunidad
find_dupes	Alternativas más económicas seleccionadas con porcentaje de coincidencia — «qué huele como X sin el precio»
find_similar	Fragancias más similares a partir de un ranking de similitud precalculado
get_recommendations	Selecciones según preferencias de notas/acordes + presupuesto + ocasión + género
compare_fragrances	Comparación lado a lado: notas, acordes compartidos/distintos, puntuaciones, diferencia de precio
trending_fragrances	Lo que los usuarios de Perfume Picks están añadiendo a sus colecciones ahora mismo
what_to_wear_tonight	Una fragancia para el momento — las selecciones para citas usan datos de cumplidos de la comunidad, las selecciones de oficina usan puntuaciones de seguridad en oficina

Cada respuesta incluye atribución de fuente, una línea de resumen lista para citar, enlaces y fechas de actualización de datos. Toda la puntuación es determinista — no se realizan llamadas de IA dentro del servidor. Todas las herramientas están marcadas como de solo lectura/idempotentes.

Instalación (Claude Desktop)

Requiere Node.js 18+.

Añade a tu claude_desktop_config.json (Claude Desktop → Configuración → Desarrollador → Editar configuración):

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

Reinicia Claude Desktop. No se necesita clave API ni configuración — el servidor incluye acceso público de solo lectura.

Configuración (opcional)

Las variables de entorno sobrescriben los valores predeterminados (solo variables de entorno explícitas — este paquete nunca lee archivos .env):

Variable	Propósito
SUPABASE_URL	Sobrescribir la URL de la base de datos
SUPABASE_SERVICE_ROLE_KEY	Solo uso interno — desbloquea las tendencias en vivo de añadidos a colecciones de 30 días. Nunca distribuyas esta clave.

Sin la clave de servicio, trending_fragrances recurre a la popularidad del catálogo y etiqueta el método en su respuesta.

Endpoint remoto (sin instalación)

Streamable HTTP para agentes web y clientes MCP que aceptan una URL:

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

También aparece en Smithery y en el registro oficial de MCP como io.github.bguillow-rgb/perfume-picks.

Ejemplos de solicitudes de agentes

Preguntas que un agente puede responder con estas herramientas:

• "¿Qué huele como Baccarat Rouge 540 sin el precio?" → find_dupes (duplicados seleccionados con % de coincidencia, p. ej. Lattafa Ana Abiyedh Rouge, 90%)
• "Recomienda una fragancia para una boda de verano." → get_recommendations con occasion: "wedding"
• "¿Qué fragancias tienen bergamota, vainilla y ámbar?" → get_recommendations con esas notas como preferences
• "¿Qué perfume es similar a Bleu de Chanel?" → find_similar
• "¿Qué debería ponerme en una cita esta noche?" → what_to_wear_tonight (puntuado por datos de cumplidos de la comunidad)
• "Compara Sauvage y Bleu de Chanel." → compare_fragrances

Ejemplo de formato de respuesta (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/" }
  }
}

Desarrollo

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

El servidor habla MCP sobre stdio. El acceso al catálogo es de solo lectura por diseño: cada ruta de consulta emite SELECTs contra tablas que son legibles públicamente bajo seguridad a nivel de fila, y está limitado a 60 llamadas/minuto.

Telemetría de uso: cada llamada de herramienta registra el nombre de la herramienta, sus argumentos, nombre/versión del cliente, duración y éxito/fracaso en una tabla de registro de solo escritura (solo inserción bajo RLS; el contenido no es legible públicamente; se purga después de 90 días). No se recopila identidad de usuario, datos de cuenta ni contenido de conversaciones. El registro es de tipo «dispara y olvida» y nunca afecta a las respuestas.

Datos y atribución

Los datos de fragancias, pirámides de notas, coincidencias de duplicados y puntuaciones de la comunidad son seleccionados por Perfume Picks. Cita libremente con atribución:

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

Las fechas de actualización en cada fragancia reflejan la última actualización de datos.