Mafunzo ya Oh-My-McDonald: Tumia AI kuuliza kuhusu McDonald’s, kulinganisha bei na kuunda picha za voxel

Oh-My-McDonald ni nini

Oh-My-McDonald ni AI Skill inayoendeshwa kwa mazungumzo, inayotumia MCP rasmi ya McDonald's. Unaweza kutumia lugha ya kawaida kuiambia AI bajeti, ladha na masharti ya kuondoa, ili itafute bidhaa halisi za chakula; pia inaweza kulinganisha bei za maduka, kuangalia kuponi na kampeni, kukokotoa taarifa za lishe, na baada ya uthibitisho kurekodi bidhaa ulizokula na maduka uliyotembelea.

Mradi hupata data ya biashara kupitia MCP rasmi ya McDonald's, kisha hutumia hati za Python za ndani kuchakata data, kuhifadhi rekodi na kuunda picha. Huhitaji kiolesura cha wavuti, wala hautegemei OpenAI API au API nyingine za kutengeneza picha.

Tembelea hazina ya Oh-My-McDonald kwenye GitHub

Mradi huu unatatua matatizo gani

• Kuuliza kuhusu bidhaa za chakula, maduka, bei, ofa na taarifa za lishe katika mazungumzo hayo hayo.
• Choosing from real candidate food items returned by MCP according to budget, taste and exclusion conditions.
• Kulinganisha bei ya bidhaa na ukubwa sawa katika hadi maduka matatu yaliyochaguliwa.
• Kuangalia kifurushi chako cha kuponi, muda wa kuisha wa ofa na kampeni zilizochapishwa.
• Kukokotoa nishati, protini, mafuta, wanga, sodiamu na kalsiamu za bidhaa zinazolingana kikamilifu.
• Kuhifadhi katalogi ya bidhaa na rekodi za kutembelea maduka baada ya mtumiaji kuthibitisha kuwa amekula au ametembelea duka.
• Kubadilisha matokeo ya utafutaji kuwa picha za PNG za mtindo wa voxel zinazofaa kutazamwa na kushirikiwa.

Mandhari nne za uonyeshaji wa voxel

Mradi una kifaa cha ndani cha Python cha kuchora voxel, ambacho kwa sasa kina miundo 43 ya voxel nzito na hutengeneza picha kwa kanuni ya pikseli 8 kwa kila seli.

Katalogi ya bidhaa

Katalogi ya bidhaa hutumia kumbi zenye sehemu mbalimbali, njia zenye kona na vibanda vya maonyesho kuonyesha maendeleo ya uchunguzi. Ni bidhaa zilizoliwa na kuthibitishwa ndizo huwashwa; bidhaa ambazo hazijathibitishwa hubaki za kijivu.

Kalenda ya ofa

Kalenda ya ofa huhesabu kulingana na tarehe za uhalali wa kifurushi chako cha kuponi, na huangazia kuponi halali leo, kuponi zinazokaribia kuisha na kampeni zilizochapishwa. Maelezo kamili yanaweza kuwekwa kwenye ukurasa unaofuata ili kuzuia taarifa zote kubanwa kwenye picha moja.

Kulinganisha bei za maduka

Mandhari ya kulinganisha bei za maduka hupanga maduka yaliyochaguliwa katika barabara ya voxel na kuonyesha bei husika mlangoni. Barabara hii ni ya uonyeshaji wa data pekee; haiwakilishi barabara halisi wala uhusiano wa kijiografia kati ya maduka.

Meza ya lishe

Mandhari ya lishe huweka vyakula vya mlo huu kwenye sahani moja na kutumia risiti kuonyesha data ya lishe. Mboga, matunda na bidhaa za maziwa ni mapendekezo ya ziada nje ya mlo, na hazitajumuishwa katika jumla ya lishe ya vyakula vilivyo kwenye sahani.

Maandalizi kabla ya usakinishaji

Kabla ya kuanza, thibitisha kuwa kompyuta hii inatimiza masharti yafuatayo:

• Python 3.11 au toleo la juu zaidi.
• Uwezo wa kuunda na kutumia mazingira pepe ya Python kwa kawaida.
• Fonti inayotumia Kichina, inapendekezwa Noto Sans CJK.
• Ikiwa unahitaji utafutaji wa wakati halisi, pata vitambulisho vya ufikiaji vya MCP rasmi ya McDonald's.

Vitegemezi vikuu vya mradi ni Pillow >=10,<13 na NumPy >=1.24,<3; vitegemezi kamili vimehifadhiwa katika requirements.txt.

Hatua ya kwanza: Kloni mradi

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

Hatua ya pili: Unda mazingira pepe

Tekeleza katika Linux au macOS:

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

Watumiaji wa Windows PowerShell watekeleze:

.venv\Scripts\Activate.ps1

Hatua ya tatu: Sakinisha vitegemezi

python -m pip install -r requirements.txt

Inapendekezwa kusakinisha vitegemezi kila mara katika mazingira pepe yaliyoamilishwa, ili kuepuka migongano na vifurushi vingine vya Python vilivyo kwenye mfumo.

Hatua ya nne: Sanidi fonti ya Kichina

Picha za voxel zina majina ya bidhaa za chakula, majina ya maduka na vichwa vya ofa kwa Kichina, hivyo fonti ya Kichina inayofanya kazi inahitajika. Baada ya kusakinisha Noto Sans CJK, unaweza kutumia OMM_FONT kubainisha njia ya faili ya fonti.

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

Badilisha njia ya mfano kwa njia ya faili ya fonti iliyopo kwenye kompyuta hii. Ikiwa Kichina hakionekani vizuri kwenye picha, kwanza kagua kigezo hiki cha mazingira na njia ya fonti.

Hatua ya tano: Angalia msaada wa amri

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

Amri hii itaonyesha amri ndogo na vigezo vinavyotolewa na hati za ndani za usaidizi. Maelezo kamili zaidi yako katika oh-my-mcdonald/references/commands.md kwenye hazina.

Kuunganisha MCP rasmi ya McDonald's

Pata Token ya MCP

Tembelea koni ya MCP ya McDonald's, kisha fuata maelekezo ya ukurasa rasmi ili kupata Token ya MCP. Vitambulisho vinapaswa kuhifadhiwa katika vigezo vya mazingira vya kompyuta hii au usanidi wa Codex; usiandike Token halisi kwenye faili za mradi wala kuiwasilisha kwenye hazina ya Git.

Sanidi Token kupitia vigezo vya mazingira

export MCD_MCP_TOKEN="YOUR_MCD_MCP_TOKEN"

Soma vitambulisho kupitia usanidi wa Codex

Ikiwa faili ya usanidi wa kompyuta hii tayari ina usanidi wa mcd-mcp, unaweza kubainisha faili hiyo waziwazi kwa kutumia --codex-config:

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

Njia zote mbili husoma vitambulisho kwenye kompyuta hii pekee. Kwa mchakato kamili wa kuunganisha, rejelea MCP_INTEGRATION.md iliyo kwenye mzizi wa hazina.

Zana za MCP zinazotumiwa na mradi

• query-nearby-stores: Kuuliza kuhusu maduka yaliyo karibu.
• query-meals: Kuuliza kuhusu bidhaa za chakula.
• query-meal-detail: Kuuliza maelezo ya bidhaa ya chakula.
• query-store-coupons: Kuuliza taarifa za ofa za duka.
• query-my-coupons: Kuuliza kifurushi cha kuponi cha mtumiaji.
• calculate-price: Kukokotoa bei ya bidhaa iliyobainishwa.
• campaign-calendar: Kuuliza kalenda ya kampeni.
• list-nutrition-foods: Kupata data ya bidhaa za chakula inayohitajika kwa ukokotoaji wa lishe.
• order-list: Kuuliza rekodi za maagizo.

Matumizi ya msingi ya kwanza: Tafuta maduka

Amri ifuatayo hutafuta maduka katika jiji la Wuhan ambayo jina au eneo lake linahusiana na “东澜岸”:

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

Baada ya kupata matokeo ya maduka, unaweza kutumia kitambulisho halali cha duka kuendelea kuuliza maelezo na bei za bidhaa za chakula.

Matumizi ya msingi ya pili: Tafuta maelezo ya bidhaa

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

• --store hutumika kubainisha kitambulisho cha duka.
• --code hutumika kubainisha msimbo wa bidhaa ya chakula.

Vitambulisho vilivyo kwenye mfano vinaonyesha tu muundo wa vigezo. Katika matumizi halisi, tumia kitambulisho halali cha duka na msimbo wa bidhaa uliorejeshwa na utafutaji wa sasa wa MCP.

Matumizi ya msingi ya tatu: Tafuta bei ya kikapu cha ununuzi

Yaliyomo kwenye kikapu hutolewa kupitia faili ya JSON, na mradi hukokotoa bei kulingana na duka lililobainishwa na mpango wa sasa wa majaribio.

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

Unapolinganisha bei za maduka, hakikisha unalinganisha bidhaa na ukubwa sawa. Mradi hulinganisha hadi maduka matatu yaliyochaguliwa, na hautabiri bei za maduka mengine kutokana na matokeo ya baadhi ya maduka.

Matumizi ya msingi ya nne: Tazama miundo ya voxel nje ya mtandao

Ikiwa huna Token ya MCP kwa sasa, bado unaweza kuthibitisha mazingira ya ndani ya uonyeshaji na kutazama miundo iliyojumuishwa:

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

Matokeo yaliyoundwa yataandikwa kwenye saraka ya output. Hatua hii inafaa kukagua ikiwa Pillow, NumPy na fonti ya Kichina zimesanidiwa vizuri.

Tumia Skill katika mteja wa AI

Mradi unatoa oh-my-mcdonald/SKILL.md ili kueleza uwezo, mtiririko wa uendeshaji na vikwazo vya mradi kwa wateja wa AI wanaotumia Skill. Mteja pia anahitaji uwezo wa kuunganisha MCP na kutekeleza amri za ndani.

Mtiririko wa kawaida ni huu:

1. Mtumiaji huwasilisha kwa lugha ya kawaida mahitaji ya bajeti, ladha, duka, ofa au lishe.
2. AI huchagua zana ya MCP inayofaa ili kupata data halisi ya biashara.
3. AI huchuja matokeo yaliyorejeshwa kulingana na bajeti na masharti ya kuondoa.
4. Huita hati za ndani za Python inapohitajika ili kuchakata data.
5. Uonyeshaji unapohitajika, kifaa cha ndani cha uonyeshaji hutengeneza PNG.
6. Inapohusu rekodi za kula au kutembelea duka, husubiri uthibitisho wazi wa mtumiaji kabla ya kuandika rekodi.

Unaweza kuiomba AI mambo kama haya:

• Leo nina bajeti ya yuan 35, sitaki chakula chenye pilipili; unapendekeza nini?
• Chagua moja bila mpangilio kutoka miongoni mwa bidhaa halisi zinazokidhi masharti.
• Linganisha bei ya mlo huu katika maduka matatu yaliyo karibu.
• Angalia kuponi ninazoweza kutumia leo na kampeni za hivi karibuni.
• Kokotoa nishati na protini za mlo huu.
• Ninathibitisha kuwa nimetoka kula burger hii; tafadhali nirekodie.
• Tengeneza katalogi ya bidhaa nilizokula.

Bidhaa zinazoteuliwa lazima zitokane na matokeo ya utafutaji wa MCP, na haziwezi kubuniwa na AI. Katika uteuzi mmoja wa nasibu, vinaweza kutumika vifurushi vya hadi bidhaa sita.

Mbinu za juu na kanuni za matumizi

Bainisha kwanza duka, bidhaa na ukubwa

Bei huathiriwa na duka, ukubwa wa bidhaa na mpango wa ofa. Kabla ya kulinganisha, bainisha bidhaa na ukubwa, na mwambie AI iorodheshe wazi maduka yaliyochaguliwa kwa utafutaji huu. Hapo ndipo matokeo yatakapoweza kulinganishwa.

Shughulikia kwa makini data ya lishe inayokosekana

Ukokotoaji wa lishe hutumia bidhaa zinazolingana kikamilifu pekee. Ikiwa baadhi ya sehemu za lishe hazipo, bainisha sehemu hizo kando; usichukulie thamani inayokosekana kuwa sifuri, wala usibadilishe kwa bidhaa yenye jina linalofanana lakini isiyoweza kuthibitishwa.

Tenganisha takwimu za ndani ya mlo na mapendekezo ya ziada

Meza ya lishe inaweza kuonyesha mapendekezo ya ziada kama mboga, matunda na bidhaa za maziwa, lakini thamani ya lishe ya mlo huu huhesabu chakula kilicho kwenye sahani pekee. Unapotafsiri picha iliyoundwa, usijumuishe bidhaa za ziada kwenye jumla.

Mtumiaji athibitishe kabla ya kurekodi

Rekodi za maagizo zinaweza kutumika tu kama taarifa zinazosubiri uthibitisho, na haziwezi kuthibitisha moja kwa moja kuwa mtumiaji amekula bidhaa fulani. Ni baada ya mtumiaji kuthibitisha wazi kuwa amekula ndipo mradi unapaswa kuhifadhi rekodi na kuwasha bidhaa kwenye katalogi; kanuni hiyo hiyo inatumika kwa rekodi za kutembelea maduka.

Elewa vizuri kalenda ya ofa

Kalenda huhesabu idadi ya kuponi kulingana na tarehe za uhalali wa kifurushi cha mtumiaji. Ikiwa kuponi inaweza kutumika katika muda, duka au bidhaa fulani, bado inapaswa kuamuliwa na masharti mahususi yaliyorejeshwa na MCP.

Linda vitambulisho vya ndani

Prefer reading the Token through the MCD_MCP_TOKEN environment variable or the local Codex configuration. Do not write credentials into scripts, sample JSON files, screenshots or version-control files.

Kuendesha Majaribio ya Kiotomatiki

Mradi unatumia Python unittest. Unaweza kuendesha amri ifuatayo katika saraka kuu ya hazina:

python -m unittest discover -s tests -v

README inaonyesha kuwa kuna majaribio 51 yaliyopo, yanayotumia data ya kuundwa kuthibitisha mantiki ya uchakataji wa biashara, matokeo na uonyeshaji. Hali ya uthibitishaji na vikwazo vya maswali halisi ya MCP vimeandikwa katika docs/VALIDATION.md.

Mipaka ya Utekelezaji ya Kuzingatia

• Mradi hauauni kuweka oda kiotomatiki, malipo au kukusanya kuponi za punguzo.
• Mradi hautoi usawazishaji wa kwenye wingu wala uchunguzi wa mara kwa mara wa chinichini.
• Ulinganishaji wa bei unahusisha hadi maduka matatu yaliyochaguliwa, na ni kwa bidhaa hiyo hiyo, ukubwa huo huo na mpango wa sasa wa majaribio pekee.
• Mtaa wa voxel ni tukio la mfano, hauna barabara halisi wala uhusiano halisi wa kijiografia.
• Data halisi ya MCP katika onyesho la kukagua ni muhtasari wa tarehe mahususi, na haiwakilishi matokeo ya moja kwa moja ya baadaye.
• Rekodi za vyakula na za kutembelea maeneo lazima zidhibitishwe na mtumiaji.

Muhtasari wa Muundo wa Mradi

• oh-my-mcdonald/SKILL.md: Faili la maelezo ya Skill la mteja wa AI.
• oh-my-mcdonald/scripts/oh_my_mcdonald.py: Skripti za usaidizi za ndani na mahali pa kuanzia kwa amri kuu.
• oh-my-mcdonald/references/commands.md: Marejeleo ya kina ya amri.
• docs/images/: Picha za onyesho la tukio.
• docs/VALIDATION.md: Matokeo ya uthibitishaji wa maswali halisi na vikwazo.
• examples/basket.json: Mfano wa JSON wa kikapu cha ununuzi.
• MCP_INTEGRATION.md: Maelezo ya ujumuishaji wa MCP na mchakato wa kuita.
• tests/: Majaribio ya kiotomatiki.

Hitimisho

Oh-My-McDonald inachanganya MCP rasmi ya McDonald's, mwingiliano wa lugha asilia na uonyeshaji wa voxel wa ndani. Inaweza kusaidia kuchagua chakula, kulinganisha bei na kuchanganua lishe, pamoja na kuunda rekodi za kibinafsi za uchunguzi zilizothibitishwa. Inapendekezwa kukamilisha kwanza uonyeshaji wa modeli nje ya mtandao na majaribio, kisha kusanidi MCP Token. Kuhusu bei, ofa na lishe, kila mara tumia data halisi ya sasa inayorejeshwa na MCP.

Mradi umetolewa kwa leseni ya MIT. Unaweza kuripoti matatizo kupitia GitHub Issues au kuwasilisha Pull Request ili kushiriki katika uboreshaji.