MaiMai tejamkor yordamchisi qo‘llanmasi: McDonald's MCP orqali buyurtmani optimallashtirish va kupon yo‘qotishlarini tahlil qilish

Loyiha haqida

MaiMai tejamkor yordamchisi (mcd-coupon-strategist) McDonald's China MCP asosida yaratilgan buyurtma xarajatlarini boshqarish yordamchisidir. U nafaqat “bu buyurtmani qanday qilib eng tejamkor tuzish mumkin?” degan savolga javob beradi, balki avvalgi buyurtmalar va kuponlar zaxirasini tahlil qilib, qaysi muddati tugayotgan kuponlar amalda yo‘qotishga aylanayotganini ham ko‘rsatadi.

Loyiha tejash masalasini ikki yo‘nalishga ajratadi:

• Qisqa muddatli optimallashtirish: joriy restoran menyusi va hisobdagi mavjud kuponlarni o‘qiydi, alohida mahsulotlar, setlar, kuponlardan foydalanish va qo‘shimcha xarid variantlarini sanab chiqadi, so‘ng har birining haqiqiy narxini calculate-price orqali oladi.
• Uzoq muddatli audit: xarajatlar, o‘rtacha chek, ko‘p olinadigan mahsulotlar va muddati yaqinlashayotgan kuponlarni tahlil qilish uchun order-list va query-my-coupons dan foydalanadi.

Loyihaning asosiy maqsadi foydalanuvchini shunchaki ko‘proq xarid qilishga undash emas, avvalo yuz berayotgan yo‘qotishlarni aniqlashdir.

Asosiy funksiyalar va ishlash tamoyili

Joriy restoran asosida haqiqiy narxlash

Turli restoranlarda narxlar va mahsulotlarning mavjudligi farq qilishi mumkin. Shu sababli loyiha menyu narxlarini oldindan belgilab qo‘ymaydi. Barcha nomzod variantlar model narxni taxmin qilmasligi uchun oxir-oqibat MCP’ning calculate-price vositasiga yuboriladi.

Natijada nafaqat eng kam haqiqiy to‘lov, balki narx farqi set tuzilishi, kupon yoki qo‘shimcha xarid mahsulotidan kelib chiqqani ham tushuntiriladi. Masalan, uchta mahsulotdan iborat set alohida burger va kartoshkadan arzonroq bo‘lishi mumkin. Bunday holatda tizim setni aniq tavsiya qiladi va qancha tejash mumkinligini ko‘rsatadi.

Qo‘shimcha xarid tuzoqlarini aniqlash

Kupondan foydalanish har doim ham ko‘proq tejashni anglatmaydi. Faraz qilaylik, dastlab 46.5 yuanlik mahsulotlar olinishi rejalashtirilgan. “50 yuandan 12 yuan chegirma” kuponidan foydalanish uchun 3.5 yuanlik mahsulot qo‘shiladi va kupondan keyingi to‘lov 38 yuanni tashkil qiladi. Agar shunga o‘xshash set atigi 33.5 yuan tursa, qo‘shimcha xarid varianti baribir 4.5 yuanga qimmatroq bo‘ladi.

Loyiha faqat kuponda ko‘rsatilgan chegirma miqdoriga emas, yakuniy to‘lovga qaraydi. Qo‘shimcha mahsulot foydalanuvchiga aslida kerak bo‘lmasa, tizim bunday variantdan voz kechishni tavsiya qiladi.

Kuponlarning yashirin xarajatini hisoblash

“Kuponning yashirin xarajati” muddati tugash arafasida bo‘lgan, ammo hali ishlatilmagan kupon qiymatidir. MCP qaytaradigan kuponda faqat nom bo‘lishi mumkinligi sababli loyiha uning qiymatini joriy restoran menyusi orqali aniqlaydi:

• Minimal xaridga chegirma kuponi: “50 yuandan xarid qilganda 12 yuan chegirma” kuponi bevosita 12 yuan deb hisoblanadi.
• Birini olsangiz, biri bepul kuponi: “O‘rta kartoshka uchun birini olsangiz, biri bepul” kuponi tegishli mahsulotning menyudagi narxi asosida hisoblanadi.
• Belgilangan narx kuponi: “9.9 yuanga o‘rta stakan muzli americano” kuponi menyudagi asl narxdan 9.9 yuanni ayirish orqali hisoblanadi.

Menyuda tegishli mahsulot topilmasa, loyiha kupon qiymatini 0 deb belgilaydi va hisobotda qayd etadi. Asossiz, shunchaki mantiqan to‘g‘ri ko‘rinadigan taxminiy qiymat kiritilmaydi.

Uzoq muddatli iste’mol odatlarini tahlil qilish

Audit moduli avvalgi buyurtmalardan buyurtmalar soni, jami xarajat, o‘rtacha chek va ko‘p olinadigan mahsulotlarni jamlaydi hamda tarkibiy tavsiyalar beradi. Masalan, bir xil burgerni bir necha marta alohida xarid qilgan bo‘lsangiz, tizim mos setni taqqoslashni tavsiya qilishi mumkin, chunki har safar setga o‘tish odatda xarajatni kamaytiradi. To‘liq qaytarilgan buyurtmalar iste’mol hisobiga kiritilmasligi uchun filtrlanadi.

Tayyorgarlik

Onlayn MCP funksiyalaridan foydalanishdan oldin quyidagi muhitni tayyorlang:

• MCP maxsus ulagichlarini qo‘llab-quvvatlaydigan mijoz, masalan, README’da namoyish etilgan WorkBuddy.
• McDonald's MCP ochiq platformasidan olingan Token.
• Mahalliy testlarni ishga tushirish kerak bo‘lsa, Python 3.8 yoki undan yuqori versiyasi.

Mahalliy to‘rtta test uchun MCP Token kerak emas. Ammo haqiqiy menyu, hisobdagi kuponlar va avvalgi buyurtmalarni tekshirish uchun amaldagi Token zarur.

MCP Token olish va sozlash

1-qadam: Token olish

McDonald's MCP ochiq platformasiga kiring, telefon raqami orqali tizimga kiring, boshqaruv panelida MCP Token’ni faollashtiring va nusxalang.

2-qadam: MCP konfiguratsiyasini yaratish

Repozitariyda maxfiy ma’lumotlari olib tashlangan mcp-config.example.json konfiguratsiya fayli mavjud. Tuzilishi quyidagicha:

{
  "mcpServers": {
    "mcd-mcp": {
      "type": "streamablehttp",
      "url": "https://mcp.mcd.cn",
      "headers": {
        "Authorization": "Bearer ${MCD_MCP_TOKEN}"
      }
    }
  }
}

${MCD_MCP_TOKEN} o‘rniga o‘z Token’ingizni kiriting va konfiguratsiyani MCP Client sozlamalariga yozing. Haqiqiy Token’ni ochiq repozitariyga yubormang, skrinshotlar, jurnallar yoki muammo xabarlarida oshkor qilmang.

3-qadam: WorkBuddy’da yoqish

1. WorkBuddy’ni oching, chap tomondan “Ekspertlar, ko‘nikmalar, ulagichlar” bo‘limiga kirib, “Ulagichlar” sahifasini tanlang.
2. “Maxsus ulagich”ni bosing, so‘ng “MCP’ni sozlash”ni tanlang.
3. Token almashtirilgan JSON konfiguratsiyasini joylang va saqlang.
4. Maxsus ulagichlar ro‘yxatiga qayting va mcd-mcpni yoqing.

Asosiy foydalanish usullari

1-misol: Budjetga mos kombinatsiya izlash

Avval restoran filialini tanlang, so‘ng budjet, kerakli taom turi va taqqoslanadigan variantlar sonini aniq ko‘rsating. Masalan:

McDonald's’dan yetkazib berish orqali buyurtma bermoqchiman, restoran tanlangandan keyin hisoblab bering:
Menda kupon bor, bitta burger + bir porsiya kartoshka + bir ichimlik xohlayman, budjetim 40 yuan,
qanday buyurtma bersam eng tejamkor bo‘ladi? Ikkita variantni taqqoslang.

Yordamchi joriy restoran menyusi va mavjud kuponlarni o‘qib, nomzod kombinatsiyalarni yaratadi va MCP orqali haqiqiy narxni hisoblaydi. Odatdagi natijada 33.5 yuanlik McSpicy tovuqli burger uchlik seti tavsiya qilinib, 37 yuanlik burger va kartoshkani alohida xarid qilish varianti bilan taqqoslanishi mumkin.

2-misol: Asosiy taom va garnirni cheklash

Budjetim 35 yuan, tovuqli asosiy taom va bitta garnir xohlayman.
Joriy restoranda mavjud mahsulotlarni tekshirib, tavsiya etiladigan, muqobil va tavsiya etilmaydigan variantlarni bering,
har bir variant nima sababdan tejamkorroq yoki qimmatroq ekanini tushuntiring.

Bunday so‘rov yordamchiga budjet, to‘yimlilik talabi va mahsulot turini bir vaqtda hisobga olishga yordam beradi. Natijada faqat mutlaq narxi eng past, ammo ehtiyojga mos kelmaydigan variant tavsiya qilinmaydi.

3-misol: Qo‘shimcha xarid qilish foydalimi yoki yo‘qmi

Menda “50 yuandan 12 yuan chegirma” kuponi bor.
Joriy ehtiyojim bo‘yicha bevosita xarid, qo‘shimcha mahsulot olib kupondan foydalanish va setga o‘tish variantlarining yakuniy to‘lovini taqqoslang.
Agar qo‘shimcha xarid qilish qimmatroq chiqsa, menga aniq ogohlantiring.

Taqqoslashda asosiy mezon yakuniy to‘lov bo‘lishi kerak, kupondagi chegirma miqdori emas. Loyiha qo‘shilgan mahsulot xarajatini ham hisobga oladi va set qo‘shimcha xariddan foydaliroq yoki yo‘qligini ko‘rsatadi.

4-misol: Yaqindagi xarajatlarni audit qilish

So‘nggi bir necha oydagi McDonald's buyurtmalarimni tahlil qiling:
buyurtmalar soni, jami xarajat va o‘rtacha chekni hisoblang, ko‘p olinadigan mahsulotlarni toping;
shuningdek, muddati yaqinlashayotgan kuponlar, taxminiy qiymati va qolgan kunlarini ko‘rsating,
nihoyat, bu oyda avval nimani hal qilishim kerakligini ayting.

Bu so‘rov uzoq muddatli audit zanjirini ishga tushiradi. Natijada asosiy e’tibor muddati yaqinlashayotgan kuponlarning jami qiymati, iste’mol odatlari va bajarish mumkin bo‘lgan tarkibiy tavsiyalarga qaratiladi, faqat bitta buyurtmaning eng past narxiga emas.

Mahalliy testlarni ishga tushirish

Loyiha manba kodini olgach, repozitariy ildiz katalogida Python 3.8 yoki undan yuqori versiya bilan quyidagi testlarni ishga tushiring:

python src/test_saver.py
python src/test_auditor.py
python src/test_adapter.py
python src/test_order_adapter.py

• test_saver.py: variantlarni sanab chiqish, saralash va qo‘shimcha xarid tuzoqlarini aniqlashni tekshiradi.
• test_auditor.py: yashirin xarajat, iste’mol odatlari va sana chegaralarini tekshiradi.
• test_adapter.py: birliklarni almashtirish va MCP javoblarini tahlil qilishni tekshiradi.
• test_order_adapter.py: buyurtma va kuponlarni tahlil qilish, qaytarilgan buyurtmalarni filtrlash hamda kupon qiymatini hisoblashni tekshiradi.

Bu to‘rtta test to‘liq mahalliy tarzda ishlaydi va MCP Token sozlamasini talab qilmaydi. README’da qo‘shimcha paketlarni o‘rnatish buyruqlari ko‘rsatilmagan, shuning uchun amaldagi kod va integratsiya hujjatlariga tayanish kerak.

Loyiha arxitekturasini tushunish

Loyiha MCP’ning xom javoblarini biznes algoritmlaridan ajratish uchun adapter qatlamidan foydalanadi. Asosiy modullar:

• src/saver.py: bitta buyurtmani tejash zanjiri uchun javob beradi, nomzod kombinatsiyalarni sanab chiqadi va haqiqiy to‘lovlarni taqqoslaydi.
• src/auditor.py: uzoq muddatli audit, kuponlarning yashirin xarajatini hisoblash va iste’mol profilini yaratish uchun javob beradi.
• src/mcd_adapter.py: maydonlarni moslashtirish, qaytarilgan buyurtmalarni filtrlash, kupon qiymatini menyudan aniqlash va yagona “fenni yuanga” aylantirish uchun javob beradi.
• MCP_INTEGRATION.md: MCP Server, vositalar, chaqiruv jarayoni va amalda tekshirilgan chaqiruv shartlarini qayd etadi.
• SKILL.md: Skill ta’rifi va umumiy ish jarayonini tavsiflaydi.

Algoritm qatlami MCP’ning xom javoblariga bevosita murojaat qilmaydi. Bu maydonlardagi farqlar va pul birliklari chalkashishining oldini olishga yordam beradi. Ayniqsa, turli interfeyslarda “fen” va “yuan” yo‘nalishlari turlicha bo‘lishi mumkin, shuning uchun barcha o‘zgartirishlar adapter qatlami orqali bajarilishi kerak.

Ilg‘or foydalanish bo‘yicha maslahatlar

Avval “nima yeyish”ni aniqlang, keyin narxlarni taqqoslang

Eng past narx har doim ham mos variant bo‘lavermaydi. So‘rovda asosiy taom, garnir, ichimlik, odamlar soni, budjet va minimal talablarni yozing. Shunda tizim bir xil ehtiyojni qondiradigan variantlarni taqqoslaydi.

Tejash sabablarini ko‘rsatishni so‘rang

“Qaysi kupon ishlatildi, qaysi setga almashtirildi, qaysi qo‘shimcha mahsulot qo‘shildi va asosiy variantga nisbatan qancha tejandi” kabi ma’lumotlarni ko‘rsatishni so‘rashingiz mumkin. Bu nafaqat xulosani olish, balki tavsiya haqiqiy ehtiyojingizga mos kelishini baholash imkonini beradi.

Kupon qiymati va haqiqiy foydani farqlang

Kupon nazariy jihatdan 12 yuan qiymatga ega bo‘lishi mumkin, ammo bu joriy buyurtmada albatta 12 yuan tejaysiz degani emas. Minimal xarid talabi, amal qiladigan restoran, mavjud mahsulotlar va qo‘shimcha xarid xarajati haqiqiy foydani o‘zgartiradi. Kupon qiymati bilan yakuniy to‘lovni birgalikda ko‘rib chiqing.

Muddati yaqin va qiymati aniq kuponlarga ustuvorlik bering

Uzoq muddatli auditda kuponlarni qolgan kunlar va tasdiqlangan qiymat bo‘yicha saralash mumkin. Menyudan asl narxini aniqlab bo‘lmaydigan kuponlar noma’lum yoki 0 sifatida belgilanishi kerak. To‘liq hisobot tuzish uchun pul miqdorini taxmin qilish mumkin emas.

Har safar joriy restoran ma’lumotlaridan foydalaning

Boshqa restoran yoki avvalgi buyurtmalardagi narxlarni qayta ishlatmang. Menyu, mahsulot mavjudligi va kuponlarning amal qilish doirasi o‘zgarishi mumkin. Har bir qaror joriy restoran bo‘yicha rasmiy real vaqt natijalariga asoslanishi kerak.

Hisob ma’lumotlarini himoya qiling

Token’ni saqlash uchun doimo muhit o‘zgaruvchilari yoki mijozning xavfsiz konfiguratsiyasidan foydalanish tavsiya etiladi. Konfiguratsiyani ochiq ulashganda faqat ${MCD_MCP_TOKEN} kabi joylashtiruvchi belgini qoldiring.

Chegaralar va e’tibor beriladigan jihatlar

• Barcha narxlar MCP calculate-price vositasining haqiqiy javobiga asoslanishi kerak.
• Menyudan tasdiqlab bo‘lmaydigan kupon qiymati 0 deb olinadi va qayd etiladi, taxmin qilinmaydi.
• Qaytarilgan buyurtmalar iste’mol xarajatiga kiritilmaydi.
• Loyiha kupondan foydalanish uchun keraksiz qo‘shimcha xaridlarni rag‘batlantirmaydi.
• Taomlar, narxlar, mahsulot mavjudligi va kuponlarning amal qilish doirasi McDonald's rasmiy kanallaridagi real vaqt natijalariga asoslanadi.
• Bu loyiha mustaqil ishlab chiqilgan tanlov ishi bo‘lib, McDonald's’ning rasmiy mahsuloti emas.
• Natijalar faqat iste’mol bo‘yicha qaror qabul qilish uchun ma’lumotnoma hisoblanadi, tibbiy, oziqaviy yoki boshqa professional maslahat emas.

Xulosa

MaiMai tejamkor yordamchisi real vaqt rejimidagi buyurtma optimallashtirishni uzoq muddatli iste’mol auditi bilan birlashtiradi: qisqa muddatda haqiqiy narxlash orqali set, alohida mahsulot va kupon kombinatsiyalarini tanlaydi, uzoq muddatda esa buyurtmalar va kuponlar zaxirasi orqali yuqori o‘rtacha chek, takroriy alohida xaridlar va muddati tugagan kuponlar kabi yashirin yo‘qotishlarni aniqlaydi.

MCP Token sozlangach, budjet va taom talablari ko‘rsatilgan oddiy buyurtma so‘rovidan boshlashingiz, keyin qo‘shimcha xaridlarni taqqoslash va oylik iste’mol auditini sinab ko‘rishingiz mumkin. Dasturchilar uchun saver.py, auditor.py va mcd_adapter.py modullarining qatlamli tuzilishi MCP orkestratsiyasining ikki zanjirli modeli uchun aniq namuna bo‘la oladi.