Isifundo se-McButler: Sebenzisa i-McDonald’s MCP ukuze uthole izincomo, uhlaziye umsoco, uqhathanise izindleko zezindawo futhi uhlele ukudla kweqembu

Yini iMcButler

IMcButler (umsizi woku-oda ozisebenzelayo wakwaMcDonald’s) iphrojekthi esiza ngoku-oda esekelwe ku-MCP esemthethweni yakwaMcDonald’s. Ayincomi nje amamenyu ngokwentengo kuphela, kodwa izama ukuphatha ngesikhathi esisodwa imikhawulo yesabelomali, impilo, isikhathi, ukudla okungadliwa kanye nokuthandwa komuntu.

Le phrojekthi ingasetshenziswa njenge-WorkBuddy Skill, noma iqhutshwe nge-CLI yasendaweni isebenzisa idatha yokubonisa eyakhelwe ngaphakathi. Onjiniyela bangaphinda basebenzise amamojula ayo okuhlaziya idatha nokukala, baxhume idatha ebuyiswa yi-McDonald’s MCP kumakhasimende abo.

Indawo yokugcina iphrojekthi iku-GitHub, kanti ithiyetha encane yakwaMcDonald’s inikeza ne-ikhasi lokuzizwisa ku-inthanethi. Qaphela ukuthi iMcButler iphrojekthi ezimele ebambe iqhaza emncintiswaneni, ayiwona umkhiqizo osemthethweni wakwaMcDonald’s.

Amakhono ayisithupha abalulekile

1. Izincomo zansuku zonke

recommend isekela izindlela ezintathu: ukonga imali, impilo kanye nokuthandwa. Zisebenzisa amalogikhi ahlukene okuhlela, esikhundleni sokushintsha inkambu eyodwa yokuhlela kuphela.

• Imodi yokonga imali: ihlanganisa inani elijwayelekile lentengo, izinga lesaphulelo kanye nentengo nge-100 kcal ngayinye, ukuze ukudla okuncane kungabi phezulu ngenxa yentengo ephelele ephansi kuphela.
• Imodi yezempilo: ihlanganisa amaphuzu ezempilo nokufaneleka kwamandla, bese ibeka phambili izinto ezinedatha yokudla okulinganisiwe.
• Imodi yokuthandwa: ihlanganisa omaka bezinto ezidume kakhulu, umlando wezinto ezi-odwa njalo kanye nezaphulelo.

2. Ukuhlolwa kwempilo

health iwumgogodla wezobuchwepheshe wephrojekthi. Njengoba i-interface yokudla inikeza idatha yezinto ngazinye kuphela, iMcButler iqala ngokufunda imininingwane yephakheji, ihlukanise iphakheji ibe yizinto zayo ezizenzakalelayo, bese iqondanisa into ngayinye nethebula lokudla futhi ihlanganise idatha efana namandla, amaprotheni, amafutha, i-sodium ne-calcium.

Imininingwane yephakheji
→ Funda ukwakheka okuzenzakalelayo
→ Qondanisa idatha yokudla yento ngayinye
→ Hlanganisa amanani okudla
→ Bala amaphuzu ezempilo nezinto ezidonsa amaphuzu

Amaphuzu ezempilo asebenzisa isikali samaphuzu ayi-100, kucatshangelwa ibanga lamandla, amaprotheni, isilinganiso samandla avela emafutheni, i-sodium, umthwalo kashukela nowamafutha kanye namaphuzu engeziwe ezithelo nemifino. Ifomula eningiliziwe ingatholakala ku-references/model-spec.md esendaweni yokugcina.

3. Ukuqhathanisa izindleko eziphelele zezitolo

stores ingakhetha isitolo ngokusondela, ngentengo ephansi noma ngezindleko eziphelele ezilinganiselwe. Imodi ehlanganisiwe ayibheki intengo yomkhiqizo kuphela, kodwa iguqula nebanga lokuya nokubuya, isikhathi sokuhamba ngezinyawo kanye nesikhathi sokulinda kube izindleko.

Izindleko eziphelele = Intengo yomkhiqizo
                    + Izindleko zebanga (ukuya nokubuya 0.5 yuan/km)
                    + Izindleko zesikhathi (isikhathi sokuhamba ngezinyawo sokuya nokubuya + isikhathi sokulinda) × 0.30 yuan/ngomzuzu

Ngakho-ke, isitolo esiseduze akusho ukuthi ngaso sonke isikhathi yisona esinenzuzo kakhulu. Isikhathi sokulinda okwamanje asihlinzekwa ngokuqondile yi-interface ye-MCP; umsebenzisi kufanele asifake noma asilinganise.

4. Ukuhlela ukudla kwamaqembu

bulk yenzelwe izimo zoku-oda ukudla zama-admin, HR, amakilasi namaqembu. Ingahlukanisa abantu ngamaqembu futhi ihlele ukudla ngokwenani labantu, isabelomali somuntu ngamunye, ukungadli inyama yenkomo nokungadli okubabayo, bese ikhipha i-orderItems engaqhubeka idluliselwe enqubweni yokubala intengo.

Imiphumela izofaka inani labantu eqenjini ngalinye, inani lamaphakheji, intengo ephelele, intengo yomuntu ngamunye, imali elondoloziwe kanye namandla omuntu ngamunye. Nokho, “ukungadli inyama yenkomo” okwamanje kuncike ekuhlungeni ngamagama asemagameni ezitsha, ngakho akunakuqinisekisa ukubona ukudla okungenazo izithako ezimakwe ngokusobala kumenyu.

5. Amaphuzu eMaiXian

credit iboleka ikhadi lokukala izikweletu zabathengi, ibale amaphuzu eMaiXian aphakathi kuka-300 no-950 e-akhawuntini naku-oda elilodwa. Izilinganiso eziyisithupha zihlanganisa ukuzinza kokugcwalisa izibopho, isigqi sokusebenzisa imali, ukuzithiba kwesabelomali, izinga lokusebenzisa izaphulelo, impahla ye-akhawunti kanye nokwehlukahlukana kokuthandwa.

Umphumela wokukala ubonisa amaphuzu esilinganiso ngasinye kanye nomthombo wedatha yawo, esikhundleni sokukhipha amaphuzu aphelele angachazeki. Lo msebenzi uwukuhlaziywa kokusebenzisa imali ngendlela yokuzijabulisa, awumele ukuhlolwa kwangempela kokwethembeka kwezezimali.

6. Ithiyetha encane yakwaMcDonald’s

theater ikhiqiza impikiswano yoku-oda phakathi kwabalingiswa abahlanu ngokusekelwe kumakhuphoni, amaphuzu eMaiXian kanye nedatha yamandla, bese ikhipha ikhasi le-HTML elinefayela elilodwa. Ikhasi elikhiqiziwe alidingi okunye ukuncika futhi lingavulwa ngqo esipheqululini.

Ukulungisa indawo yokusebenza

Imodi yasendaweni idinga kuphela i-Python 3.8 noma inguqulo engaphezulu, futhi isebenzisa i-standard library ye-Python kuphela, ngaphandle kokufaka amaphakheji ezinkampani zangaphandle. Imodi ye-MCP eku-inthanethi idinga i-MCP Token esebenzayo.

Clone indawo yokugcina bese uqhuba ukuzihlola

git clone https://github.com/jouaaaaaa/mcd-self-butler.git
cd mcd-self-butler
python scripts/selftest.py

Ukuzihlola kuqukethe izimo ezi-9 ezingadingi i-inthanethi, ezihlanganisa ukuhlolwa kwempilo, izincomo ezintathu, amaphuzu eMaiXian e-akhawunti na-oda, ukudla kweqembu, ukuqhathanisa izitolo kanye nethiyetha encane esebenzisa umbhalo kuphela. Uma konke kudlula, kusho ukuthi indawo yasendaweni nedatha yokubonisa kusebenza kahle.

Indlela yokuqala: Faka njenge-Skill ku-WorkBuddy

1. Faka i-SKILL.md, scripts/ kanye references/ kusuka endaweni yokugcina kule folda elandelayo:

   ~/.workbuddy/skills/mcd-self-butler/

2. Ku-WorkBuddy, ngena ku-“Ochwepheshe · Amakhono · Izixhumi”, bese ukhetha ngokulandelana “Izixhumi”, “Izixhumi ezenziwe ngokwezifiso” kanye “Lungiselela i-MCP”.

3. Gcwalisa ukumiswa kwe-Streamable HTTP kwe-McDonald’s MCP, bese ufaka i-Token yakho esikhundleni sombhalo obekelwe yona:

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

4. Vula isixhumi se-mcd-mcp, bese wethula izidingo ngolimi lwemvelo.

Ungaqala ngezicelo ezilandelayo:

• “NgiseNanjing West Road, yisiphi isitolo sakwaMcDonald’s esiseduze esithengisa i-Big Mac combo yezinto ezintathu ngentengo engcono kakhulu?”
• “Ngisize ngihlole ukuthi le phakheji inama-calorie amangaki, nokuthi ikhona yini indlela enempilo yokuyishintsha.”
• “Ukudla kweqembu labantu abangu-30 emnyangweni, yuan 30 umuntu ngamunye, abantu aba-5 abadli inyama yenkomo.”
• “Athini amaphuzu ami eMaiXian?”
• “Nginesithukuthezi ngesikhathi sokulinda ukudla, benze baxabane.”

Indlela yesibili: Sebenzisa i-CLI yasendaweni

I-CLI yasendaweni isebenzisa isifinyezo sedemo esikwindawo yokugcina, ayidingi Token futhi ayidingi uxhumano lwe-inthanethi. Amakhono ayisithupha abizwa ngokufanayo nge-scripts/mcd_butler.py.

Hlola ukudla kwephakheji

python scripts/mcd_butler.py health \
  --nutrition demo/nutrition.txt \
  --combo demo/combo_9900011128.json

Lo myalo uzohlukanisa iphakheji, uqhathanise nethebula lokudla bese ukhiqiza umphumela ofingqiwe. Okuphumayo kuhlanganisa idatha yokudla yezinto ezakha iphakheji, isamba sephakheji, amaphuzu ezempilo nezizathu ezithile zokudonswa kwamaphuzu.

Thola izincomo ezinempilo

python scripts/mcd_butler.py recommend \
  --menu demo/menu_1450118.json \
  --nutrition demo/nutrition.txt \
  --mode healthy \
  --meal lunch \
  --budget 45 \
  --top 5 \
  --details demo/details.json

--mode healthy kusho ukusebenzisa imodi yezempilo, --meal lunch icacisa isimo sesidlo sasemini, --budget 45 ibeka isabelomali ku-yuan 45, kanti --top 5 ibuyisa imiphumela emihlanu yokuqala.

Ukuhlola amanye amasu, ungashintsha usebenzise umqondo wokonga imali noma wokuthandwa ngokwamamodi asekelwa yi-CLI. Imiphumela yamamodi ahlukene ingahluka kakhulu, ngoba isebenzisa imisebenzi yenani ehlukene.

Bala amaphuzu eMaiXian

python scripts/mcd_butler.py credit \
  --orders demo/orders.json \
  --account demo/account.json \
  --coupons demo/coupons.md \
  --nutrition demo/nutrition.txt

Lo myalo uhlanganisa ama-oda omlando, ulwazi lwe-akhawunti, amakhuphoni nedatha yokudla, bese ukhipha amaphuzu aphelele, izinga kanye nemininingwane yezilinganiso eziyisithupha. Umphumela oyisibonelo kudatha yedemo ungamaphuzu angu-771, ezingeni le-Big Mac, kodwa amaphuzu angempela ancike kudatha efakiwe.

Hlela ukudla kwabantu abangu-30

python scripts/mcd_butler.py bulk \
  --menu demo/menu_1450118.json \
  --nutrition demo/nutrition.txt \
  --headcount 30 \
  --budget 30 \
  --no-beef 5 \
  --no-spicy 4

Lapha kusethwe abantu abangu-30, isabelomali somuntu ngamunye esingu-yuan 30, abantu aba-5 abangadli inyama yenkomo kanye nabangu-4 abangadli okubabayo. Uhlelo luzohlukanisa abantu ngamaqembu, lukhethe amaphakheji futhi lukhiqize izinto zama-oda ezingabalwa ngobuningi.

Qhathanisa izindleko eziphelele zezitolo

python scripts/mcd_butler.py stores \
  --stores demo/stores.json \
  --mode balanced

Imodi ye-balanced ihlanganisa ibanga, isikhathi nentengo. Uma usebenzisa idatha yakho, kufanele unikeze noma ulinganise ngokucacile isikhathi sokulinda; ungathathi inani lesibonelo njengomphumela wesikhathi sangempela.

Khiqiza ithiyetha encane yakwaMcDonald’s

python scripts/mcd_butler.py theater \
  --context demo/theater_context.json \
  --out theater.html

Ngemva kokuqalisa, kuzokwenziwa i-theater.html kufolda yamanje. Yivule ngqo esipheqululini ukuze ubuke izingxoxo zabalingiswa, amabhamuza enkulumo avela kancane kancane kanye nomphumela wokwahlulela wokugcina.

Indlela yesithathu: Xhuma iklayenti lakho le-MCP

Onjiniyela bangasebenzisa izindlela ezimbili zokuhlanganisa.

1. Londoloza izimpendulo ezingacutshungulwanga: Klayentini le-MCP, biza amathuluzi ezitolo, amamenyu, imininingwane, ukudla, ama-oda noma amakhuphoni, bese ulondoloza izimpendulo ezingacutshungulwanga kumafayela anenhloso efanayo nezibonelo eziku-demo/, bese uzidlulisela ku-CLI ukuze zicutshungulwe.
2. Biza amamojula ngokuqondile: Ngenisa imisebenzi eku-scripts/lib/, udlulisele ngqo i-Python dict ebuyiswe yi-MCP.

Ungqimba lokulayisha idatha, i-mcdata.py, lwamukela kokubili impendulo eluhlaza ye-MCP esesimweni esithi {"success": true, "data": ...} kanye nefomethi eyenziwe yaba lula ngesandla. Ngakho ngokuvamile ungagcina impendulo yethuluzi ngqo, ngaphandle kokuyihlanza ngesandla kuqala.

Qonda ukwakheka kwephrojekthi

Inqubo yokusebenza yeMcButler ingafingqwa ngezendlalelo ezine:

1. Ungqimba lweklayenti: I-WorkBuddy Agent noma elinye iklayenti le-MCP liqala isicelo.
2. Ungqimba lwesevisi ye-MCP: Ithola idatha yezitolo, amamenyu, imininingwane, ukudla, ukubalwa kwentengo, amakhuphoni, amaphuzu nama-oda.
3. Ungqimba lokulayisha idatha: I-mcdata.py iphethe ukukhipha, ukujwayelela kanye nokuqondanisa amagama ngendlela engaqinile.
4. Ungqimba lwamamodeli ebhizinisi: I-health.py, credit.py, bulk.py, recommend.py kanye theater.py zenza ngokulandelana ukukala, ukuhlela ukudla, ukuncoma kanye nokukhiqiza umbhalo weshashalazi.

mcd_butler.py iyindawo yokungena ehlanganisiwe ye-CLI, engakhipha i-Markdown noma i-JSON, elungele ukubukwa ngabantu futhi elula ukuxhunywa ezinhlelweni ezilandelayo.

Amasu okusebenzisa athuthukile

Beka imininingwane yephakheji kuqala

I-interface yokudla inikeza idatha yezinto ngazinye kuphela. Lapho uhlaziya iphakheji, kungcono ukuthumela kanye nemininingwane yephakheji, ukuze uhlelo lubheke into ngayinye ngokwakheka okuzenzakalelayo. Uma kungekho neyodwa idatha yokudla ehambisanayo, iphrojekthi izobonisa amaphuzu ezempilo ngokuthi “—”, esikhundleni sokuqamba umphumela.

Khetha imodi yezincomo ngokwesimo

• Uma isabelomali siqinile, sebenzisa imodi yokonga imali futhi unake intengo nge-100 kcal ngayinye.
• Ezimweni zokwehlisa amafutha omzimba noma zokuzivocavoca, sebenzisa imodi yezempilo futhi uhlole imininingwane yokudonswa kwamaphuzu kumaprotheni, amafutha ne-sodium.
• Uma ufuna ukuhlanganisa ukudla okudumile nokuthandwa kwakho komlando, sebenzisa imodi yokuthandwa.

Gcina idatha eluhlaza ye-MCP ukuze ukwazi ukuphinda ukhiqize imiphumela

Lapho ulungisa imiphumela yezincomo, kunconywa ukuthi ugcine impendulo eluhlaza ye-MCP yalokho kusebenza. Ngale ndlela, noma imenyu, amanani noma isimo sokutholakala kushintsha kamuva, usengasebenzisa leyo datha efanayo ukuphinda ukhiqize inqubo yokubala.

Hlukanisa ikhwalithi yedatha

IMcButler isebenzisa amazinga amathathu okumaka idatha:

• Kuhloliwe: Idatha etholwe ngokuhlukanisa iphakheji bese kuhlanganiswa imininingwane yento ngayinye.
• Esemthethweni: Idatha evela ngokuqondile kuthebula lokudla kwento eyodwa.
• Isilinganiso: Isilinganiso esilinganiselwe lapho idatha ephelele ingatholakali, futhi imakwa ngokusobala.

Lapho ubonisa imiphumela ngokuzenzakalelayo, akufanele ususe lezi zimpawu. Zisiza abasebenzisi ukuthi bahlukanise umthombo wedatha nezinga lokuthembeka kwayo.

Hlola imingcele yebhizinisi

Umsebenzi wamanje wokudla kwamaqembu awukakuxhumi nokulungiselela okuhlanganisiwe kwemithetho yezaphulelo zokuthenga ngobuningi ezinkampanini; inketho yokungadli inyama yenkomo isekelwe ikakhulukazi kumagama asemqoka egameni lesidlo; isikhathi sokulinda naso sidinga ukufakwa ngokusobala. Ngaphambi kokusebenzisa iphrojekthi kuma-oda angempela, kufanele uphinde uqinisekise amanani, isimo sokutholakala nezithako zokudla ngesiteshi esisemthethweni sakwaMcDonald's.

Ukuhlaziywa kokudla okunomsoco kwenzelwe ulwazi kuphela, futhi akusona iseluleko sezokwelapha, sokudla okunomsoco noma esinye iseluleko sochwepheshe. Uma kuhileleka izifo, ukukhulelwa noma ukudla kwezingane, kufanele kuboniswane nochwepheshe.

Isiphetho

IMcButler ikhombisa ukuthi idatha eluhlaza ye-MCP ingaguqulwa kanjani ibe izinqumo zokuthenga ezichazekayo: kusukela ekuhlukaniseni amaphakheji, ekulinganiseni ukudla okunomsoco nasekubaleni izindleko ezigcwele zesitolo, kuya ekuhlukaniseni amaqembu okudla, emaphuzwini okuzijabulisa nokuqukethwe okusebenzisanayo, konke kungasetshenziswa nge-CLI ehlanganisiwe noma nge-WorkBuddy Skill.

Ukuze uzame okokuqala, kunconywa ukuthi uqale usebenzise python scripts/selftest.py, bese uzama ngokulandelana health, recommend kanye stores. Ngemva kokuqinisekisa inqubo engaxhunyiwe ku-inthanethi, lungiselela i-MCP Token ukuze uxhume kudatha yesikhathi sangempela.