Percolate — Specialty Coffee Database & Brew Recipes

Servidor MCP Percolate

Consulte o banco de dados de cafés especiais Percolate pelo Claude, ou qualquer cliente de IA compatível com MCP. Acesso somente leitura a mais de 1.100 cafés selecionados com perfis de degustação, receitas de preparo, harmonizações e links de onde comprar.

Percolate é o diário de cafés especiais para iOS — disponível na App Store.

Ferramentas

Ferramenta	O que faz
search_coffees	Busca no catálogo com filtros de categoria, nível de torra, método de preparo e preço
get_coffee	Registro completo de um café: torra, corpo/acidez/doçura, sabores, harmonizações, varejistas
find_similar	Cafés semelhantes por sobreposição de sabores e proximidade de torra/corpo/acidez
get_recommendations	Sugestões com base em preferências de sabor + orçamento + torra + seus equipamentos de preparo
compare_coffees	Comparação lado a lado: perfis, sabores compartilhados/distintos, diferença de preço
trending_coffees	O que os usuários do Percolate estão adicionando às suas coleções agora
dial_in_suggestion	Orientação de preparo para um café específico — receitas selecionadas (proporção, temperatura, moagem) do catálogo, ou um ponto de partida baseado na torra
what_to_brew	Um café para agora — opções noturnas tendem a descafeinados, manhãs tendem a cafés brilhantes

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 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": {
    "percolate": {
      "command": "npx",
      "args": ["-y", "percolate-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 à coleção nos últimos 30 dias. Nunca distribua esta chave.

Sem a chave de serviço, trending_coffees recorre à popularidade do catálogo e rotula o método em sua resposta.

Endpoint remoto (sem instalação)

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

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

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

Exemplos de solicitações de agentes

Perguntas que um agente pode responder com estas ferramentas:

• "Recomende uma torra média com notas de chocolate e nozes." → get_recommendations com preferences: ["chocolate","nutty"], roast_level: "medium"
• "Como devo preparar este Onyx Monarch em uma V60?" → dial_in_suggestion (receitas selecionadas: proporção, temperatura, moagem)
• "Qual café funciona para espresso abaixo de $20?" → search_coffees com brew_method: "espresso", price_max: 20
• "O que devo preparar esta noite?" → what_to_brew (opções noturnas tendem a descafeinados automaticamente)
• "Encontre algo semelhante a este natural etíope." → find_similar
• "Compare estes dois pacotes." → compare_coffees

Exemplo de formato de resposta (truncado):

{
  "method": "curated_pairing",
  "recipes": [
    { "recipe": "Pour-over (V60), 1:16, 205°F",
      "why": "clarity that lets the delicate, high-acid notes open up" }
  ],
  "attribution": {
    "source": "Percolate — Specialty Coffee Journal",
    "links": { "website": "https://percolateapp.com/" }
  }
}

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 contra 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 (insert-only 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 é fire-and-forget e nunca afeta as respostas.

Dados e atribuição

Dados de café, perfis de degustação, receitas de preparo e harmonizações são selecionados pela Percolate. Links de varejistas podem ser links de afiliados. Cite livremente com atribuição:

Fonte: Percolate — Diário de Cafés Especiais (percolateapp.com)

As datas de atualização em cada café refletem a última atualização de dados.