Pour Picks — Bourbon & Whiskey Database

Servidor MCP de Pour Picks

Consulta la base de datos de bourbon y whiskey de Pour Picks desde Claude, o cualquier cliente de IA compatible con MCP. Acceso de solo lectura a más de 4.700 botellas con perfiles de cata estructurados, precios, maridajes y valoraciones de la comunidad.

Pour Picks es el diario del coleccionista de bourbon para iOS — consíguelo en la App Store.

Herramientas

Herramienta	Qué hace
search_bottles	Búsqueda de texto completo en el catálogo con filtros de categoría, precio y graduación
get_bottle	Registro completo de una botella (por ID o nombre): perfil de cata, precio, maridajes, valoraciones de la comunidad
find_similar	Botellas con un perfil de sabor similar, ordenadas por notas compartidas y proximidad de cuerpo/dulzor/tostado
find_cheaper_alternative	Mismo estilo, perfil similar, precio más bajo
get_recommendations	Selecciones según preferencias de sabor + presupuesto + ocasión
compare_bottles	Comparativa lado a lado: graduación, edad, precio, sabores compartidos y distintos, valoraciones
trending_bottles	Lo que los usuarios de Pour Picks están añadiendo a sus bodegas ahora mismo
pour_tonight_suggestion	Una copa para esta noche, según el estado de ánimo, la ocasión y la temporada

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.

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": {
    "pour-picks": {
      "command": "npx",
      "args": ["-y", "pour-picks-mcp"]
    }
  }
}

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

Desde una copia local

{
  "mcpServers": {
    "pour-picks": {
      "command": "node",
      "args": ["/path/to/pour-picks/mcp-server/dist/index.js"]
    }
  }
}

Configuración (opcional)

El servidor funciona con configuración cero usando la clave pública de solo lectura de Pour Picks. Las variables de entorno anulan los valores predeterminados:

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

Sin la clave de servicio, trending_bottles recurre a la popularidad del catálogo y etiqueta el método en su respuesta (method: "catalog_popularity_tier" vs "cellar_adds_last_30_days").

Endpoint remoto (sin instalación)

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

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

También aparece en Smithery (puerta de enlace pour-picks--bguillow.run.tools) y en el registro oficial de MCP como io.github.bguillow-rgb/pour-picks.

Ejemplos de solicitudes de agentes

Preguntas que un agente puede responder con estas herramientas:

• "¿Qué bourbon es similar a Eagle Rare pero más fácil de encontrar?" → find_similar
• "Recomienda un bourbon de menos de $60 con notas de vainilla, roble y caramelo." → get_recommendations con taste_preferences: ["vanilla","oak","caramel"], budget: 60
• "¿Qué sabe como Blanton's sin el precio?" → find_cheaper_alternative
• "Compara Eagle Rare y Buffalo Trace." → compare_bottles
• "¿Qué bourbon debería servir en una noche fría?" → pour_tonight_suggestion con season: "winter"
• "¿Qué botellas están añadiendo los coleccionistas ahora mismo?" → trending_bottles

Ejemplo de formato de respuesta (truncado):

{
  "cheaper_alternatives": [
    { "name": "Buffalo Trace W.L. Weller 12 Year", "price_usd": 49.99,
      "similarity": 0.78, "savings_usd": 15.0,
      "shared_flavors": ["caramel", "oak"] }
  ],
  "attribution": {
    "source": "Pour Picks — The Bourbon Collector's Journal",
    "links": { "website": "https://pourpicks.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 ejecuta SELECTs sobre 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). No se recopila identidad de usuario, datos de cuenta ni contenido de conversaciones. El registro es de tipo disparar y olvidar y nunca afecta a las respuestas.

Publicación

• npm: npm publish desde este directorio (el campo mcpName en package.json vincula el paquete con la entrada del registro).
• Registro MCP: server.json en este directorio es el manifiesto del registro. Publica con la CLI de mcp-publisher después de que el paquete npm esté disponible: mcp-publisher login github && mcp-publisher publish.

Datos y atribución

Los datos de botellas, perfiles de cata y maridajes están curados por Pour Picks. Cita libremente con atribución:

Fuente: Pour Picks — El diario del coleccionista de bourbon (pourpicks.app)

Los recuentos de valoraciones de la comunidad se incluyen con cada valoración para que puedas juzgar el tamaño de la muestra. Las fechas de actualización en cada botella reflejan la última pasada de enriquecimiento.