Oh-My-McDonald qo‘llanmasi: AI yordamida McDonald’s haqida ma’lumot olish, narxlarni solishtirish va voksel tasvir yaratish

Oh-My-McDonald nima

Oh-My-McDonald — McDonald's rasmiy MCP asosida ishlaydigan, dialog orqali boshqariladigan AI Skill. AI'ga tabiiy tilda budjet, did va istisno shartlarini aytib, haqiqiy taomlarni qidirishingiz mumkin; shuningdek, restoranlardagi narxlarni taqqoslash, kuponlar va aksiyalarni ko‘rish, oziqaviy qiymatlarni hisoblash hamda tasdiqlaganingizdan so‘ng yegan taomlaringiz va borgan restoranlaringizni qayd etish mumkin.

Loyiha biznes ma’lumotlarini McDonald's rasmiy MCP orqali oladi, keyin esa mahalliy Python skriptlari ma’lumotlarni qayta ishlaydi, yozuvlarni saqlaydi va rasmlarni yaratadi. Unga veb-interfeys kerak emas, shuningdek OpenAI API yoki boshqa rasm generatsiyasi API'lariga bog‘liq emas.

Oh-My-McDonald GitHub omboriga kirish

Loyiha qanday muammolarni hal qiladi

• Bitta suhbat davomida taomlar, restoranlar, narxlar, aksiyalar va oziqaviy ma’lumotlarni qidirish.
• Budjet, did va istisno shartlari asosida MCP qaytargan haqiqiy nomzod taomlar orasidan tanlash.
• Ko‘pi bilan uchta tanlangan restoranda bir xil mahsulot va bir xil o‘lcham narxlarini taqqoslash.
• Shaxsiy kuponlar to‘plami, kuponlarning amal qilish muddati va e’lon qilingan aksiyalarni ko‘rish.
• Aniq mos keladigan taomlarning energiya, oqsil, yog‘, uglevod, natriy va kalsiy miqdorini hisoblash.
• Foydalanuvchi taomni amalda yeganini yoki restoranga borganini tasdiqlagandan so‘ng taomlar katalogi va restoran tashrifi yozuvlarini saqlash.
• Qidiruv natijalarini ko‘rish va ulashish qulay bo‘lgan voksel uslubidagi PNG rasmlarga aylantirish.

Voksel vizualizatsiyasining to‘rt sahnasi

Loyihada Python voksel rendereri o‘rnatilgan. Hozirda unda 43 ta yirik voksel modeli mavjud bo‘lib, rasmlar har bir katak 8 piksel bo‘lishi qoidasi asosida yaratiladi.

Taomlar katalogi

Taomlar katalogi bo‘limlarga ajratilgan ko‘rgazma zallari, burilishli yo‘laklar va taomlar stendlari orqali o‘rganish jarayonini namoyish etadi. Faqat amalda yeyilgan va tasdiqlanib saqlangan taomlar yoritiladi, tasdiqlanmagan taomlar esa kulrangligicha qoladi.

Chegirmalar taqvimi

Chegirmalar taqvimi shaxsiy kuponlar to‘plamining amal qilish sanalari asosida tuziladi va bugun amal qiladigan kuponlar, yaqinda muddati tugaydigan kuponlar hamda e’lon qilingan aksiyalarni alohida ko‘rsatadi. Ma’lumotlar bitta rasmga haddan tashqari tiqilib qolmasligi uchun to‘liq tafsilotlar keyingi sahifalarga joylashtirilishi mumkin.

Restoranlarda narxlarni taqqoslash

Restoranlarda narxlarni taqqoslash sahnasida tanlangan restoranlar voksel ko‘chasiga joylashtiriladi va kirish qismida tegishli narx ko‘rsatiladi. Bu ko‘cha faqat ma’lumotlarni vizualizatsiya qilish uchun ishlatiladi; u haqiqiy yo‘llar yoki restoranlar o‘rtasidagi geografik munosabatni anglatmaydi.

Oziqaviy dasturxoni

Oziqaviy sahnada ushbu ovqatdagi mahsulotlar bitta likopchaga joylashtiriladi, oziqaviy ma’lumotlar esa chek ko‘rinishida ko‘rsatiladi. Sabzavotlar, mevalar va sut mahsulotlari ovqatdan tashqari qo‘shimcha tavsiyalar hisoblanadi va likopchadagi taomlarning umumiy oziqaviy qiymatiga qo‘shilmaydi.

O‘rnatishdan oldingi tayyorgarlik

Boshlashdan oldin kompyuteringiz quyidagi talablarga javob berishiga ishonch hosil qiling:

• Python 3.11 yoki undan yuqori versiyasi.
• Python virtual muhitini yaratish va undan foydalanish imkoniyati.
• Xitoy tilini qo‘llab-quvvatlaydigan shrift, tavsiya etiladi: Noto Sans CJK.
• Real vaqt rejimida qidirish kerak bo‘lsa, McDonald's rasmiy MCP'iga kirish ma’lumotlari.

Loyihaning asosiy bog‘liqliklari Pillow >=10,<13 va NumPy >=1.24,<3 bo‘lib, barcha bog‘liqliklar requirements.txt faylida qayd etilgan.

1-qadam: Loyihani klonlash

git clone https://github.com/xiaozhangup/Oh-My-McDonald.git
cd Oh-My-McDonald

2-qadam: Virtual muhit yaratish

Linux yoki macOS tizimida bajaring:

python -m venv .venv
source .venv/bin/activate

Windows PowerShell foydalanuvchilari bajaring:

.venv\Scripts\Activate.ps1

3-qadam: Bog‘liqliklarni o‘rnatish

python -m pip install -r requirements.txt

Bog‘liqliklarni doimo faollashtirilgan virtual muhitda o‘rnatish tavsiya etiladi. Bu tizim Python' idagi boshqa paketlar bilan ziddiyatlarning oldini oladi.

4-qadam: Xitoy tilidagi shriftni sozlash

Voksel rasmlarida xitoycha taom nomlari, restoran nomlari va aksiya sarlavhalari mavjud, shuning uchun xitoy tilini qo‘llab-quvvatlaydigan shrift kerak. Noto Sans CJK o‘rnatilgandan so‘ng, shrift fayli yo‘lini OMM_FONT orqali ko‘rsatishingiz mumkin.

export OMM_FONT="/path/to/your/font.ttf"

Namunadagi yo‘lni kompyuteringizda mavjud bo‘lgan shrift faylining haqiqiy yo‘li bilan almashtiring. Rasmlardagi xitoycha matn to‘g‘ri ko‘rsatilmasa, avvalo ushbu muhit o‘zgaruvchisi va shrift yo‘lini tekshiring.

5-qadam: Buyruqlar yordamiga qarash

python oh-my-mcdonald/scripts/oh_my_mcdonald.py --help

Bu buyruq mahalliy yordamchi skript taqdim etadigan quyi buyruqlar va parametrlarni ko‘rsatadi. Batafsilroq ma’lumot ombordagi oh-my-mcdonald/references/commands.md faylida joylashgan.

McDonald's rasmiy MCP'iga ulanish

MCP tokenini olish

McDonald's MCP konsoliga kiring va rasmiy sahifadagi ko‘rsatmalarga muvofiq MCP tokenini oling. Hisob ma’lumotlari kompyuteringizdagi muhit o‘zgaruvchisida yoki Codex konfiguratsiyasida saqlanishi kerak. Haqiqiy tokenni loyiha fayllariga yozmang yoki Git omboriga yubormang.

Tokenni muhit o‘zgaruvchisi orqali sozlash

export MCD_MCP_TOKEN="YOUR_MCD_MCP_TOKEN"

Hisob ma’lumotlarini Codex konfiguratsiyasi orqali o‘qish

Agar kompyuteringizdagi konfiguratsiya faylida mcd-mcp konfiguratsiyasi allaqachon mavjud bo‘lsa, faylni --codex-config orqali aniq ko‘rsatishingiz mumkin:

python oh-my-mcdonald/scripts/oh_my_mcdonald.py \
  --codex-config /本机/config.toml stores --city 武汉 --keyword 东澜岸

Har ikkala usul ham hisob ma’lumotlarini faqat mahalliy kompyuterdan o‘qiydi. To‘liq ulanish jarayoni uchun ombor ildizidagi MCP_INTEGRATION.md fayliga murojaat qiling.

Loyiha foydalanadigan MCP vositalari

• query-nearby-stores: yaqin atrofdagi restoranlarni qidirish.
• query-meals: taomlarni qidirish.
• query-meal-detail: taom tafsilotlarini qidirish.
• query-store-coupons: restoran aksiyalari haqidagi ma’lumotlarni qidirish.
• query-my-coupons: foydalanuvchi kuponlar to‘plamini qidirish.
• calculate-price: ko‘rsatilgan mahsulot narxini hisoblash.
• campaign-calendar: aksiyalar taqvimini qidirish.
• list-nutrition-foods: oziqaviy qiymatni hisoblash uchun kerakli taom ma’lumotlarini olish.
• order-list: buyurtmalar tarixini qidirish.

Asosiy foydalanish 1: Restoranlarni qidirish

Quyidagi buyruq Uxan shahrida nomi yoki joylashuvida “东澜岸” bilan bog‘liq restoranlarni qidiradi:

python oh-my-mcdonald/scripts/oh_my_mcdonald.py stores \
  --city 武汉 \
  --keyword 东澜岸

Restoran natijalari olingach, taom tafsilotlari va narxlarini qidirishni davom ettirish uchun amaldagi restoran ID'sidan foydalanishingiz mumkin.

Asosiy foydalanish 2: Taom tafsilotlarini qidirish

python oh-my-mcdonald/scripts/oh_my_mcdonald.py detail \
  --store 1960151 \
  --code 9900005456

• --store restoran ID'sini ko‘rsatish uchun ishlatiladi.
• --code taom kodini ko‘rsatish uchun ishlatiladi.

Misoldagi ID'lar faqat parametrlar formatini tushuntirish uchun berilgan. Amaliy foydalanishda MCP'ning joriy qidiruv natijalarida qaytarilgan amaldagi restoran ID'si va taom kodlaridan foydalaning.

Asosiy foydalanish 3: Savat narxini qidirish

Savat tarkibi JSON fayli orqali beriladi. Loyiha ko‘rsatilgan restoran va joriy test rejasi asosida narxni hisoblaydi.

python oh-my-mcdonald/scripts/oh_my_mcdonald.py quote \
  --store 1960151 \
  --basket examples/basket.json

Restoranlarda narxlarni taqqoslashda bir xil mahsulot va bir xil o‘lcham taqqoslanayotganiga ishonch hosil qiling. Loyiha ko‘pi bilan uchta tanlangan restoranni taqqoslaydi va ayrim restoranlar natijalariga asoslanib boshqa restoranlar narxini taxmin qilmaydi.

Asosiy foydalanish 4: Voksel modellarini oflayn ko‘rish

Agar hozircha MCP tokeni bo‘lmasa, avval mahalliy render muhitini tekshirishingiz va o‘rnatilgan modellarni ko‘rishingiz mumkin:

python oh-my-mcdonald/scripts/oh_my_mcdonald.py \
  --out output models

Yaratilgan natijalar output katalogiga yoziladi. Bu qadam Pillow, NumPy va xitoycha shrift to‘g‘ri sozlanganini tekshirish uchun qulay.

AI mijozida Skill'dan foydalanish

Loyiha oh-my-mcdonald/SKILL.md faylini taqdim etadi. U Skill'ni qo‘llab-quvvatlaydigan AI mijozlariga loyiha imkoniyatlari, ishlash jarayoni va cheklovlarini tushuntiradi. Mijoz MCP'ga ulanish va mahalliy buyruqlarni bajarish imkoniyatiga ham ega bo‘lishi kerak.

Odatdagi jarayon quyidagicha:

1. Foydalanuvchi tabiiy tilda budjet, did, restoran, aksiya yoki oziqaviy ehtiyojlarini bildiradi.
2. AI haqiqiy biznes ma’lumotlarini olish uchun tegishli MCP vositasini tanlaydi.
3. AI qaytarilgan natijalarni budjet va istisno shartlari asosida saralaydi.
4. Zaruratga ko‘ra mahalliy Python skriptlarini chaqirib, ma’lumotlarni qayta ishlaydi.
5. Vizualizatsiya kerak bo‘lsa, mahalliy renderer PNG yaratadi.
6. Taom yeyish yoki restoranga tashrif buyurish yozuvlari kerak bo‘lsa, avval foydalanuvchining aniq tasdig‘ini kutadi, keyin yozuvni saqlaydi.

AI'ga quyidagiga o‘xshash so‘rovlar yuborishingiz mumkin:

• Bugun budjetim 35 yuan, achchiq taom xohlamayman. Nima tavsiya qilasiz?
• Shartlarga mos haqiqiy taomlardan bittasini tasodifiy tanlang.
• Ushbu to‘plam narxini yaqin atrofdagi uchta restoranda taqqoslang.
• Bugun foydalanishim mumkin bo‘lgan kuponlarim va so‘nggi aksiyalarni ko‘rsating.
• Bu ovqatning energiyasi va oqsil miqdorini hisoblang.
• Hozirgina bu burgerni yeganimni tasdiqlayman, iltimos, qayd eting.
• Men yegan taomlarim asosida katalog rasmi yarating.

Nomzod taomlar MCP qidiruv natijalaridan olinishi shart, AI ularni to‘qib chiqara olmaydi. Bir martalik tasodifiy tanlovda ko‘pi bilan oltita nomzod taom kombinatsiyasidan foydalanish mumkin.

Ilg‘or usullar va foydalanish tamoyillari

Avval restoran, mahsulot va o‘lchamni aniqlang

Narxga restoran, mahsulot o‘lchami va aksiya rejasi ta’sir qiladi. Taqqoslashdan oldin mahsulot va o‘lchamni belgilab oling hamda AI'dan tanlangan restoranlarni aniq sanab berishini so‘rang. Shundagina olingan natijalarni to‘g‘ri taqqoslash mumkin.

Oziqaviy ma’lumotlar yetishmasligini qat’iy ko‘rsating

Oziqaviy hisoblashda faqat aniq mos keladigan taomlar ishlatiladi. Ayrim oziqaviy maydonlar yetishmasa, yetishmayotgan bandlarni alohida ko‘rsating. Yetishmayotgan qiymatlarni nol deb qabul qilmang va nomi o‘xshash, ammo tasdiqlanmagan mahsulot bilan almashtirmang.

Ovqat ichidagi hisob-kitob va ovqatdan tashqari tavsiyalarni ajrating

Oziqaviy dasturxonda sabzavotlar, mevalar va sut mahsulotlari kabi qo‘shimcha tavsiyalar ko‘rsatilishi mumkin, ammo ushbu ovqatning oziqaviy qiymati faqat likopchadagi mahsulotlarni hisobga oladi. Yaratilgan rasmni sharhlashda ovqatdan tashqari tavsiya etilgan mahsulotlarni umumiy hisobga qo‘shmaslik kerak.

Qayd etishdan oldin foydalanuvchi tasdig‘ini oling

Buyurtmalar tarixi faqat tasdiqlanishi kutilayotgan ma’lumot sifatida ishlatilishi mumkin, u foydalanuvchi ma’lum bir taomni yeganini bevosita isbotlamaydi. Faqat foydalanuvchi amalda yeganini aniq tasdiqlagandan keyingina loyiha yozuvni saqlashi va katalogdagi taomni yoritishi kerak. Restoranga tashrif yozuvlari ham xuddi shu tamoyilga amal qiladi.

Chegirmalar taqvimini to‘g‘ri tushuning

Taqvim kuponlar sonini shaxsiy kuponlar to‘plamining amal qilish sanalari asosida hisoblaydi. Kuponni ma’lum vaqt oralig‘ida, restoranda yoki mahsulotga qo‘llash mumkinmi-yo‘qmi, buni MCP qaytargan aniq shartlar asosida aniqlash kerak.

Mahalliy hisob ma’lumotlarini himoya qiling

Tokenni o‘qish uchun avvalo MCD_MCP_TOKEN muhit o‘zgaruvchisidan yoki kompyuterdagi Codex konfiguratsiyasidan foydalaning. Hisob ma’lumotlarini skriptlar, namunaviy JSON fayllari, skrinshotlar yoki versiyalarni boshqarish fayllariga yozmang.

Avtomatlashtirilgan testlarni ishga tushirish

Loyiha Python unittest dan foydalanadi. Uni repozitoriy ildiz katalogida ishga tushirish mumkin:

python -m unittest discover -s tests -v

README’da mavjud testlar soni 51 ta ekani qayd etilgan. Ular biznes jarayonlari, chiqish ma’lumotlari va renderlash mantiqini sintetik ma’lumotlar yordamida tekshiradi. Haqiqiy MCP so‘rovlarini tekshirish holati va cheklovlar docs/VALIDATION.md faylida qayd etilgan.

Amalga oshirish chegaralari

• Loyiha avtomatik buyurtma berish, to‘lov qilish yoki kuponlarni olishni qo‘llab-quvvatlamaydi.
• Loyiha bulut orqali sinxronlash va fonda so‘rov yuborish imkoniyatlarini taqdim etmaydi.
• Narx taqqoslash ko‘pi bilan uchta tanlangan do‘konni qamrab oladi va faqat bir xil mahsulot, bir xil variant hamda joriy test rejasi uchun amal qiladi.
• Voxel ko‘chasi namoyishiy sahna bo‘lib, haqiqiy yo‘llar yoki geografik joylashuv munosabatlarini o‘z ichiga olmaydi.
• Ko‘rib chiqishdagi haqiqiy MCP ma’lumotlari muayyan sanaga tegishli surat bo‘lib, keyingi real vaqt natijalarini ifodalamaydi.
• Ovqatlanish qaydlari va tashrif qaydlari foydalanuvchi tomonidan tasdiqlanishi shart.

Loyiha kataloglari haqida qisqacha

• oh-my-mcdonald/SKILL.md: AI mijozlari uchun Skill tavsifi fayli.
• oh-my-mcdonald/scripts/oh_my_mcdonald.py: mahalliy yordamchi skript va asosiy buyruqlar kirish nuqtasi.
• oh-my-mcdonald/references/commands.md: batafsil buyruqlar ma’lumotnomasi.
• docs/images/: sahna ko‘rib chiqish rasmlari.
• docs/VALIDATION.md: haqiqiy so‘rovlarni tekshirish natijalari va cheklovlar.
• examples/basket.json: xarid savatchasi JSON namunasi.
• MCP_INTEGRATION.md: MCP ulanishi va chaqiruvlar jarayoni tavsifi.
• tests/: avtomatlashtirilgan testlar.

Xulosa

Oh-My-McDonald McDonald’s rasmiy MCP’si, tabiiy tildagi muloqot va mahalliy voxel renderlashni birlashtiradi. U taom tanlash, narxlarni taqqoslash va oziqaviy tahlilga yordam beradi, shuningdek tasdiqlangan shaxsiy izlanish qaydlarini yuritish imkonini beradi. Avval oflayn modelni renderlash va testlarni yakunlash, so‘ng MCP Token’ni sozlash tavsiya etiladi. Narxlar, aksiyalar va oziqaviy ma’lumotlar bo‘yicha har doim MCP tomonidan ayni vaqtda qaytarilgan haqiqiy ma’lumotlarga tayaning.

Loyiha MIT License asosida ochiq manba sifatida tarqatiladi. Muammolar haqida GitHub Issues orqali xabar berish yoki takomillashtirishda qatnashish uchun Pull Request yuborish mumkin.