Doppio Coffee MCP

Peça café da torrefação DOPPIO diretamente pelo MCP

GitHub

Documentação

☕ Servidor MCP Doppio Coffee

Doppio Coffee MCP

Peça café especial torrado na hora da torrefação DOPPIO (Žilina, Eslováquia) diretamente por assistentes de IA.

Recursos

Navegue pelo Catálogo de Cafés - Filtre por origem, nível de torra, notas de sabor, acidez, amargor
Sugestões Personalizadas - A IA recomenda cafés com base nas suas preferências salvas
Pedido com Um Clique - Crie o checkout com desconto automático de 20% do MCP
Salve Preferências - Lembre-se do seu método de preparo, tamanho favorito e endereço de entrega
Torrefação Eslovaca - Café fresco de Žilina, enviado para toda a Europa

Início Rápido

Opção 1: Baixar Pacote (Mais Fácil)

Baixe doppio-coffee-mcp.mjs em Releases
Adicione à configuração do Claude Desktop:

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

Reinicie o Claude Desktop e comece a pedir café!

Opção 2: npx (Recomendado)

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

Nota: A flag -y confirma automaticamente a instalação do pacote.

Opção 3: Compilar a partir do Código-Fonte

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"]
    }
  }
}

Ferramentas Disponíveis

`list_coffees`

Navegue pelos cafés disponíveis com filtros poderosos.

Parâmetro	Tipo	Descrição
`preparation`	`filter` \| `espresso` \| `omni`	Método de preparo
`coffee_type`	`robusta` \| `arabica` \| `blend` \| `decaf`	Tipo de café
`size`	`small` \| `medium` \| `large`	Tamanho do pacote
`origin`	string	País (ex.: "Brasil", "Etiópia")
`roast_level`	string	Nível de torra (Clara, Média, Escura)
`price_max`	number	Preço máximo em EUR
`flavor`	string	Nota de sabor (chocolate, frutas, nozes...)
`altitude_min`	number	Altitude mínima em metros
`acidity_min` / `acidity_max`	1-5	Nível de acidez (maior = mais brilhante)
`bitterness_min` / `bitterness_max`	1-5	Nível de amargor (maior = mais intenso)

Exemplo: "Mostre-me cafés etíopes com notas frutadas abaixo de 15 EUR"

`get_coffee_detail`

Obtenha informações detalhadas sobre um café específico, incluindo história de origem, método de processamento e notas de degustação.

Parâmetro	Tipo	Descrição
`coffee_id`	string	ID do café no catálogo

`create_order`

Crie um pedido com desconto automático de 20% do MCP.

Parâmetro	Tipo	Descrição
`items`	array	Lista de cafés para pedir
`items[].coffee_id`	string	ID do café
`items[].size`	`small` \| `medium` \| `large`	Tamanho do pacote
`items[].quantity`	number	Número de pacotes
`email`	string	E-mail para o pedido (opcional se já salvo)

Exemplo: "Peça 2 pacotes grandes de Dolce Vita"

`set_preferences`

Salve suas preferências de café para pedidos mais rápidos.

Parâmetro	Tipo	Descrição
`preparation`	`filter` \| `espresso` \| `omni`	Seu método de preparo
`coffee_type`	string	Tipo de café preferido
`default_size`	`small` \| `medium` \| `large`	Tamanho padrão do pacote
`email`	string	E-mail para pedidos
`shipping_address`	object	Seu endereço de entrega

`get_preferences`

Recupere suas preferências salvas.

Tamanhos de Pacote

Tamanho	Peso	Ideal Para
pequeno	220g	Experimentar novos cafés
	330g	Apenas cafés para filtro
médio	500g	Consumo regular
grande	1kg	Consumidores diários, escritórios

Exemplos de Conversas

Navegação:

"Que cafés você tem da Etiópia?" "Mostre-me algo com notas de chocolate e baixa acidez" "Quero uma torra clara para preparo com filtro"

Pedidos:

"Peça um pacote grande de Dolce Vita" "Vou querer 2x médio de Ruanda e 1x grande do Brasil" "Repita meu café de sempre"

Preferências:

"Eu uso máquina de espresso, lembre disso" "Meu tamanho padrão deve ser grande" "Salve meu e-mail como joao@exemplo.com"

Desenvolvimento

# Install dependencies
npm install

# Build TypeScript
npm run build

# Watch mode (auto-rebuild)
npm run dev

# Run server
npm start

Estrutura do Projeto

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

Suporte

Para dúvidas ou problemas:

Site: www.kavadoppio.sk
Issues: GitHub Issues

Licença

Licença MIT - consulte LICENSE para detalhes.

DOPPIO Coffee - Torrado na hora em Žilina, Eslováquia 🇸🇰