Percolate — Specialty Coffee Database & Brew Recipes

Servidor MCP de Percolate

Consulta la base de datos de café de especialidad de Percolate desde Claude o cualquier cliente de IA compatible con MCP. Acceso de solo lectura a más de 1100 cafés seleccionados con perfiles de cata, recetas de preparación, maridajes y enlaces de compra.

Percolate es la revista de café de especialidad para iOS — disponible en la App Store.

Herramientas

Herramienta	Qué hace
search_coffees	Búsqueda en el catálogo con filtros de categoría, nivel de tueste, método de preparación y precio
get_coffee	Registro completo de un café: tueste, cuerpo/acidez/dulzor, sabores, maridajes, comercios
find_similar	Cafés similares por solapamiento de sabores y proximidad de tueste/cuerpo/acidez
get_recommendations	Selecciones según preferencias de sabor + presupuesto + tueste + tu equipo de preparación
compare_coffees	Comparación lado a lado: perfiles, sabores compartidos/distintos, diferencia de precio
trending_coffees	Lo que los usuarios de Percolate están añadiendo a sus colecciones ahora mismo
dial_in_suggestion	Guía de preparación para un café específico — recetas seleccionadas (proporción, temperatura, molienda) del catálogo, o un punto de partida según el tueste
what_to_brew	Un café para este momento — las selecciones nocturnas tienden a ser descafeinadas, las matutinas a ser más brillantes

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

Instalación (Claude Desktop)

Requiere Node.js 18+.

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

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

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

Configuración (opcional)

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

Variable	Propósito
SUPABASE_URL	Anular 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 los últimos 30 días. Nunca distribuyas esta clave.

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

Endpoint remoto (sin instalación)

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

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

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

Ejemplos de solicitudes de agentes

Preguntas que un agente puede responder con estas herramientas:

• "Recomiéndame un tueste medio con notas de chocolate y frutos secos." → get_recommendations con preferences: ["chocolate","nutty"], roast_level: "medium"
• "¿Cómo debería preparar este Onyx Monarch en una V60?" → dial_in_suggestion (recetas seleccionadas: proporción, temperatura, molienda)
• "¿Qué café sirve para espresso por menos de $20?" → search_coffees con brew_method: "espresso", price_max: 20
• "¿Qué debería preparar esta noche?" → what_to_brew (las selecciones nocturnas tienden al descafeinado automáticamente)
• "Encuéntrame algo similar a este natural etíope." → find_similar
• "Compara estas dos bolsas." → compare_coffees

Ejemplo de forma de respuesta (truncada):

{
  "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/" }
  }
}

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 construcción: cada ruta de consulta ejecuta SELECTs sobre tablas legibles públicamente bajo seguridad a nivel de fila, y está limitado a 60 llamadas/minuto.

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

Datos y atribución

Los datos del café, los perfiles de cata, las recetas de preparación y los maridajes están seleccionados por Percolate. Los enlaces de comercios pueden ser enlaces de afiliado. Cita libremente con atribución:

Fuente: Percolate — Revista de Café de Especialidad (percolateapp.com)

Las fechas de actualización de cada café reflejan la última actualización de datos.