Doppio Coffee MCP

Pide café de la tostaduría DOPPIO directamente a través de MCP

Documentación

☕ Servidor MCP Doppio Coffee

Doppio Coffee MCP

Pide café de especialidad recién tostado de tostaduría DOPPIO (Žilina, Eslovaquia) directamente a través de asistentes de IA.

Características

Explorar catálogo de café - Filtrar por origen, nivel de tueste, notas de sabor, acidez, amargor
Sugerencias personalizadas - La IA recomienda cafés según tus preferencias guardadas
Pedido con un clic - Crea el checkout con un 20% de descuento MCP automático
Guardar preferencias - Recuerda tu método de preparación, tamaño favorito y dirección de envío
Tostaduría eslovaca - Café fresco de Žilina, enviado a toda Europa

Inicio rápido

Opción 1: Descargar el paquete (la más fácil)

Descarga doppio-coffee-mcp.mjs desde Releases
Añádelo a la configuración de Claude Desktop:

{
  "mcpServers": {
    "doppio-coffee": {
      "command": "node",
      "args": ["/path/to/doppio-coffee-mcp.mjs"]
    }
  }
}

Reinicia Claude Desktop y ¡empieza a pedir café!

Opción 2: npx (recomendada)

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

Nota: La bandera -y confirma automáticamente la instalación del paquete.

Opción 3: Compilar desde el código fuente

git clone https://github.com/tomas-chudjak/doppio-coffee-mcp.git
cd doppio-coffee-mcp/mcp-server
npm install
npm run build

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

Herramientas disponibles

`list_coffees`

Explora los cafés disponibles con potentes filtros.

Parámetro	Tipo	Descripción
`preparation`	`filter` \| `espresso` \| `omni`	Método de preparación
`coffee_type`	`robusta` \| `arabica` \| `blend` \| `decaf`	Tipo de café
`size`	`small` \| `medium` \| `large`	Tamaño del paquete
`origin`	string	País (p. ej., "Brasil", "Etiopía")
`roast_level`	string	Nivel de tueste (Claro, Medio, Oscuro)
`price_max`	number	Precio máximo en EUR
`flavor`	string	Nota de sabor (chocolate, fruta, frutos secos...)
`altitude_min`	number	Altitud mínima en metros
`acidity_min` / `acidity_max`	1-5	Nivel de acidez (más alto = más brillante)
`bitterness_min` / `bitterness_max`	1-5	Nivel de amargor (más alto = más intenso)

Ejemplo: "Muéstrame cafés etíopes con notas afrutadas por menos de 15 EUR"

`get_coffee_detail`

Obtén información detallada sobre un café específico, incluida la historia de su origen, el método de procesamiento y las notas de cata.

Parámetro	Tipo	Descripción
`coffee_id`	string	ID del café del catálogo

`create_order`

Crea un pedido con un 20% de descuento MCP automático.

Parámetro	Tipo	Descripción
`items`	array	Lista de cafés para pedir
`items[].coffee_id`	string	ID del café
`items[].size`	`small` \| `medium` \| `large`	Tamaño del paquete
`items[].quantity`	number	Número de bolsas
`email`	string	Correo electrónico para el pedido (opcional si está guardado)

Ejemplo: "Pide 2 bolsas grandes de Dolce Vita"

`set_preferences`

Guarda tus preferencias de café para pedir más rápido.

Parámetro	Tipo	Descripción
`preparation`	`filter` \| `espresso` \| `omni`	Tu método de preparación
`coffee_type`	string	Tipo de café preferido
`default_size`	`small` \| `medium` \| `large`	Tamaño de paquete predeterminado
`email`	string	Correo electrónico para pedidos
`shipping_address`	object	Tu dirección de envío

`get_preferences`

Recupera tus preferencias guardadas.

Tamaños de paquete

Tamaño	Peso	Ideal para
pequeño	220 g	Probar cafés nuevos
	330 g	Solo cafés de filtro
mediano	500 g	Consumo habitual
grande	1 kg	Consumidores diarios, oficinas

Ejemplos de conversaciones

Explorar:

"¿Qué cafés tienes de Etiopía?" "Muéstrame algo con notas de chocolate y poca acidez" "Quiero un tueste claro para preparación de filtro"

Pedir:

"Pide una bolsa grande de Dolce Vita" "Me llevo 2x Ruanda mediano y 1x Brasil grande" "Repite mi pedido habitual de café"

Preferencias:

"Uso una máquina de espresso, recuérdalo" "Mi tamaño predeterminado debería ser grande" "Guarda mi correo como john@example.com"

Desarrollo

# Install dependencies
npm install

# Build TypeScript
npm run build

# Watch mode (auto-rebuild)
npm run dev

# Run server
npm start

Estructura del proyecto

mcp-server/
├── src/
│   ├── index.ts      # MCP server & tool definitions
│   ├── api.ts        # Backend API client
│   ├── preferences.ts # Local preferences storage
│   └── types.ts      # TypeScript interfaces
├── dist/             # Compiled JavaScript
└── package.json

Soporte

Para preguntas o problemas:

Sitio web: www.kavadoppio.sk
Incidencias: GitHub Issues

Licencia

Licencia MIT: consulta LICENSE para más detalles.

DOPPIO Coffee - Recién tostado en Žilina, Eslovaquia 🇸🇰