Pour Picks — Bourbon & Whiskey Database

Servidor MCP Pour Picks

Consulte o banco de dados de bourbon e whiskey Pour Picks a partir do Claude, ou qualquer cliente de IA compatível com MCP. Acesso somente leitura a mais de 4.700 garrafas com perfis de degustação estruturados, preços, harmonizações e avaliações da comunidade.

Pour Picks é o diário do colecionador de bourbon para iOS — obtenha na App Store.

Ferramentas

Ferramenta	O que faz
search_bottles	Pesquisa de catálogo em texto completo com filtros de categoria, preço e teor alcoólico
get_bottle	Registro completo de uma garrafa (por ID ou nome): perfil de degustação, preço, harmonizações, avaliações da comunidade
find_similar	Garrafas com perfil de sabor semelhante, classificadas por notas compartilhadas e proximidade de corpo/doçura/carvão
find_cheaper_alternative	Mesmo estilo, perfil semelhante, preço mais baixo
get_recommendations	Seleções com base em preferências de sabor + orçamento + ocasião
compare_bottles	Comparação lado a lado: teor alcoólico, idade, preço, sabores compartilhados e distintos, avaliações
trending_bottles	O que os usuários do Pour Picks estão adicionando às suas adegas agora
pour_tonight_suggestion	Uma dose para hoje à noite, com base no humor, ocasião e estação

Toda resposta inclui atribuição de fonte, uma linha de resumo pronta para citação, links e datas de atualização dos dados. Toda pontuação é determinística — nenhuma chamada de IA ocorre dentro do servidor.

Instalação (Claude Desktop)

Requer Node.js 18+.

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

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

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

A partir de um checkout local

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

Configuração (opcional)

O servidor funciona com zero configuração usando a chave pública somente leitura do Pour Picks. Variáveis de ambiente substituem os padrões:

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 à adega nos últimos 30 dias. Nunca distribua esta chave.

Sem a chave de serviço, trending_bottles recorre à popularidade do catálogo e rotula o método em sua resposta (method: "catalog_popularity_tier" vs "cellar_adds_last_30_days").

Endpoint remoto (sem instalação)

HTTP transmissível para agentes web e clientes MCP que aceitam uma URL:

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

Também listado no Smithery (gateway pour-picks--bguillow.run.tools) e no registro oficial MCP como io.github.bguillow-rgb/pour-picks.

Exemplos de solicitações de agentes

Perguntas que um agente pode responder com estas ferramentas:

• "Qual bourbon é semelhante ao Eagle Rare, mas mais fácil de encontrar?" → find_similar
• "Recomende um bourbon abaixo de US$ 60 com notas de baunilha, carvalho e caramelo." → get_recommendations com taste_preferences: ["vanilla","oak","caramel"], budget: 60
• "O que tem gosto de Blanton's sem o preço?" → find_cheaper_alternative
• "Compare Eagle Rare e Buffalo Trace." → compare_bottles
• "Qual bourbon devo servir em uma noite fria?" → pour_tonight_suggestion com season: "winter"
• "Quais garrafas os colecionadores estão adicionando agora?" → trending_bottles

Exemplo de formato de resposta (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/" }
  }
}

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 que são 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/fracasso em uma tabela de log somente gravação (somente inserção sob RLS; o conteúdo não é publicamente legível). 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.

Publicação

• npm: npm publish a partir deste diretório (o campo mcpName no package.json vincula o pacote à entrada do registro).
• Registro MCP: server.json neste diretório é o manifesto do registro. Publique com a CLI mcp-publisher depois que o pacote npm estiver ativo: mcp-publisher login github && mcp-publisher publish.

Dados e atribuição

Dados de garrafas, perfis de degustação e harmonizações são curados pela Pour Picks. Cite livremente com atribuição:

Fonte: Pour Picks — The Bourbon Collector's Journal (pourpicks.app)

As contagens de avaliações da comunidade são incluídas em cada avaliação para que você possa julgar o tamanho da amostra. As datas de atualização em cada garrafa refletem a última passagem de enriquecimento.