Repolode
Enviar
Ayzzz123

Ayzzz123/mcd-coupon-strategist

Uma Skill baseada no MCP do McDonald's China que calcula a forma mais barata de fazer um pedido na sua loja e alerta sobre cupons prestes a vencer.

Ver no GitHubSite
Estrelas
576
Forks
20
Issues abertas
0
Último commit
há 6 dias

O que é?

mcd-coupon-strategist é um assistente em Python para calcular o custo de pedidos, desenvolvido com base no servidor MCP do McDonald's China. Para um único pedido, ele busca o cardápio atual da loja e os cupons disponíveis nela, enumera combinações de itens avulsos, combos, cupons acumulados e itens adicionais e calcula o preço de cada opção com a ferramenta calculate-price do MCP. Em seguida, recomenda a opção mais barata e avisa quando adicionar itens para atingir o valor mínimo de um cupom acaba custando mais.

Para acompanhar os gastos ao longo do tempo, ele consulta pedidos anteriores e a lista de cupons da conta para informar o valor dos cupons próximos do vencimento, o gasto médio por pedido e os padrões de consumo por horário. Também verifica o saldo de pontos e as datas de vencimento, além de listar as datas das campanhas junto com a validade dos cupons. Quando há um código de cupom, o valor é calculado com calculate-price; caso contrário, é estimado com base nos preços do cardápio. Valores desconhecidos são indicados como desconhecidos, sem estimativas.

A demonstração funciona offline com respostas MCP gravadas na pasta fixtures e usa apenas a biblioteca padrão do Python, então não exige token para testar. Para executá-la com o servidor ativo, é necessário um token MCP do McDonald's.

Recursos principais

  • 01Compara pedidos com itens avulsos, combos e cupons na loja atual.
  • 02Calcula o preço de cada opção com a ferramenta calculate-price do MCP, em vez de fazer estimativas.
  • 03Avisa quando acumular cupons ou adicionar itens acaba custando mais.
  • 04Informa quais cupons estão próximos do vencimento e seu valor nominal, com base nos dados de cupons atuais e anteriores.
  • 05Resume o histórico de pedidos com o gasto médio e os horários de consumo.
  • 06Funciona totalmente offline no modo de demonstração, usando respostas gravadas.

Casos de uso

  • Escolher a combinação de refeições mais barata dentro de um orçamento fixo em uma loja do McDonald's.
  • Verificar se vale a pena usar um cupom ou adicionar itens para atingir o valor mínimo exigido.
  • Acompanhar cupons e pontos prestes a vencer em uma conta do McDonald's.
  • Aprender a criar um fluxo de pedidos baseado em MCP com um design de adaptador em camadas.

Início rápido

  1. 1

    Clone o repositório

    git clone https://github.com/Ayzzz123/mcd-coupon-strategist.git
  2. 2

    Entre no diretório do projeto

    cd mcd-coupon-strategist
  3. 3

    Execute a demonstração sem configuração (não é necessário um MCP Token)

    python demo.py

Antes de usar

  • Para usar em produção, é necessário um MCP Token do McDonald's China, obtido em open.mcd.cn.
  • A estimativa de economia de cupons sem código de barras ou sem correspondência no menu pode aparecer como desconhecida.

Tópicos

#mcp#agent#llm#cost-optimization#coupon#python#workflow-automation#mcd-mcp#mcdonalds#skill

Perguntas frequentes

O que é mcd-coupon-strategist?
Uma Skill baseada no MCP do McDonald's China que calcula a forma mais barata de fazer um pedido na sua loja e alerta sobre cupons prestes a vencer. mcd-coupon-strategist é um assistente em Python para calcular o custo de pedidos, desenvolvido com base no servidor MCP do McDonald's China. Para um único pedido, ele busca o cardápio atual da loja e os cupons disponíveis nela, enumera combinações de itens avulsos, combos, cupons acumulados e itens adicionais e calcula o preço de cada opção com a ferramenta calculate-price do MCP. Em seguida, recomenda a opção mais barata e avisa quando adicionar itens para atingir o valor mínimo de um cupom acaba custando mais.
mcd-coupon-strategist é gratuito? Qual é a licença?
mcd-coupon-strategist é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
mcd-coupon-strategist ainda é mantido?
Manutenção ativa. O último commit de mcd-coupon-strategist foi em 14 de out. de 2026.
Para que posso usar mcd-coupon-strategist?
Escolher a combinação de refeições mais barata dentro de um orçamento fixo em uma loja do McDonald's. Verificar se vale a pena usar um cupom ou adicionar itens para atingir o valor mínimo exigido. Acompanhar cupons e pontos prestes a vencer em uma conta do McDonald's. Aprender a criar um fluxo de pedidos baseado em MCP com um design de adaptador em camadas.
Como instalar mcd-coupon-strategist?
Clone o repositório: git clone https://github.com/Ayzzz123/mcd-coupon-strategist.git Entre no diretório do projeto: cd mcd-coupon-strategist Execute a demonstração sem configuração (não é necessário um MCP Token): python demo.py
Onde consigo mcd-coupon-strategist?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Ayzzz123/mcd-coupon-strategist

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados