Isifundo se-M餐搭子: Dala izinhlelo ezintathu zokuhlanganisa ukudla kwaMcDonald's usebenzisa imenyu ebukhoma, isabelomali nemigomo yokudla okunomsoco

Yini i-M餐搭子

M餐搭子 iyi-Skill ehlakaniphile yokuhlanganisa ukudla, esekelwe kudatha ye-McDonald's MCP. Udinga kuphela ukufaka idolobha, indawo ephawulekayo, isabelomali, umkhawulo wamakhalori kanye nenhloso yamaprotheni; yona izosesha izitolo eziseduze ezivumela ukuzithathela, iqondanise imenyu yamanje nedatha yokudla okunomsoco, bese ikhipha izinhlanganisela ezintathu zokudla ezingasetshenziswa.

Ngokungafani namathuluzi ancoma umkhiqizo owodwa kuphela, i-M餐搭子 ibonisa intengo, amakhalori, amaprotheni, ukusetshenziswa kwesabelomali, amakhalori asele kanye nesizathu sokuncoma kwenhlanganisela ngayinye. Ivumela futhi abasebenzisi ukuthi bavule uchungechunge lwezingcingo ze-MCP ukuze babone isimo nesikhathi sokusebenza se-Tool ngayinye.

Le phrojekthi ibambe iqhaza emqhudelwaneni wokusungula izinhlelo wabahleli bezinhlelo we-McDonald's wango-2026, kodwa akuwona umkhiqizo osemthethweni we-McDonald's. Ukutholakala kokudla, amanani kanye nemikhankaso kufanele kusekelwe olwazini lwangempela oluvela eziteshini ezisemthethweni ze-McDonald's, futhi imiphumela ayithathwa njengeseluleko sezokwelapha noma sokudla okunomsoco.

Iyiphi inkinga exazululwa yiphrojekthi

Ubunzima boku-oda ukudla ngokuvamile abubangelwa ukushoda kwezinketho, kodwa bubangelwa ukuthi imenyu, ulwazi lokudla okunomsoco, izaphulelo kanye nemigomo yomuntu kutholakala ezindaweni ezahlukene. Umsebenzisi kufanele alawule isabelomali namakhalori, mhlawumbe afune nokwandisa amaprotheni, bese enquma ukuthi inhlanganisela iphelele yini.

Indlela ye-M餐搭子 iwukuvumela umsebenzisi ukuthi achaze imingcele yalokhu kudla kuqala, bese ibala imiphumela isebenzisa imenyu yangempela, kunokuba umsebenzisi anqume imikhiqizo ethile kusenesikhathi. Ihlanganisa amanani emenyu, idatha yokudla okunomsoco kanye nolwazi lwezaphulelo endaweni eyodwa yokusebenza, okwenza inqubo yokuncoma iqondakale futhi iqinisekiswe kalula.

Amakhono abalulekile

• Ukusesha izitolo ngesikhathi sangempela: Isebenzisa query-nearby-stores ukuthola izitolo eziseduze ezivumela ukuzithathela, ngokusekelwe edolobheni nasendaweni ephawulekayo.
• Ukufunda imenyu ngesikhathi sangempela: Isebenzisa query-meals ukuthola amanani, amanani okuqala, izithombe zemikhiqizo kanye namathegi esitolo samanje.
• Ukuqhathanisa ukudla okunomsoco: Isebenzisa list-nutrition-foods ukuqondanisa imikhiqizo yemenyu nedatha yamakhalori namaprotheni.
• Imiphumela emithathu yokuhlanganisa ukudla: Ibuyisa “Okukhethwa ngokulinganisela”, “Ukwengeza amaprotheni” kanye “Inhlanganisela elula”, ukuze inganiki impendulo eyodwa engachazeki kuphela.
• Izinkomba ezichazekayo: Ibonisa amaprotheni ngeyunithi yemali, ukusetshenziswa kwesabelomali, amakhalori asele kanye nomehluko wesaphulelo.
• Izaphulelo nemikhankaso: Ibiza available-coupons kanye campaign-calendar ukuze ibonise ndawonye amakhuphoni atholakalayo nemikhankaso eseduze.
• Ukulandeleka kwezingcingo: Abasebenzisi bangabuka isimo nesikhathi sokusebenza kwezingcingo ze-MCP Tool.
• Ukwehla okuphephile: Uma i-Token ingalungiselelwanga noma i-Tool ingatholakali okwesikhashana, uhlelo lusebenzisa isifinyezo sedemo esingadaluli ulwazi, esibhalwe ngokucacile.

Ukulungiselela ngaphambi kokusebenza

Inguqulo ye-MCP yesikhathi sangempela idinga ukuthi usebenzise isevisi ye-Node ekhona endaweni yokugcina ikhodi. Ngaphambi kokuqala, lungisa le ndawo elandelayo:

• Node.js 20 noma inguqulo ephakeme
• npm 10 noma inguqulo ephakeme
• I-McDonald's MCP Token; uma ufuna ukubuka idatha yedemo kuphela, awudingi ukuyinikeza

Uma ungafuni ukufaka okwamanje, ungavakashela idemo eku-inthanethi ye-GitHub Pages. Le nguqulo iyidemo esebenza ngaphambili kuphela, esekela ukulungiswa okuphelele kwemibandela nokubalwa kokuhlanganiswa kokudla, kodwa isebenzisa isifinyezo semenyu esingadaluli ulwazi esikhundleni sedatha ye-MCP yesikhathi sangempela.

Ukufaka nokulungisa

Isinyathelo sokuqala: Klona bese ufaka okudingekayo

Qalisa imiyalo elandelayo esigungwini. Faka ikheli langempela esikhundleni sendawo ebekelwe ikheli lenqolobane:

git clone <your-repository-url>
cd mcd-meal-mate
npm install
cp .env.example .env

Isinyathelo sesibili: Lungisa okuguquguqukayo kwemvelo

Vula ifayela .env elisempandeni yephrojekthi, bese ufaka i-MCP Token kanye nechweba lesevisi:

MCD_MCP_TOKEN=YOUR_MCD_MCP_TOKEN
PORT=8787

• MCD_MCP_TOKEN akuyona into ephoqelekile. Uma ilungisiwe, kuvulwa i-MCP yesikhathi sangempela; uma ingalungisiwe, kusetshenziswa idatha yedemo.
• PORT akuyona into ephoqelekile; inani elizenzakalelayo ngu-8787.

I-MCP Token kufanele ibekwe kuphela kokuguquguqukayo kwemvelo kuseva. Ungayibhali kukhodi engaphambili futhi ungayithumeli enqolobaneni yomphakathi.

Isinyathelo sesithathu: Qalisa indawo yokuthuthukisa

npm run dev

Ngemva kokuqalisa, vakashela http://localhost:5173 kusiphequluli. Umyalo wokuthuthukisa usebenzisa i-Express API futhi uvule i-Vite hot reload, okulungele ukulungisa isixhumi esibonakalayo kanye nengqondo yeseva.

Imodi yedemo ngaphandle kokulungisa i-Token

Uma ungenayo i-McDonald's MCP Token, ungakha bese uqala inguqulo yokukhiqiza:

npm install
npm run build
npm start

Bese uvakashela http://localhost:8787. Ngalesi sikhathi ikhasi lizobonisa ngokucacile “Idatha yedemo”, kanti imenyu, amanani nemikhankaso kuzovela kusifinyezo esingadaluli ulwazi.

Imodi yedemo ilungele ukuhlola ukuhamba kokuxhumana, imikhawulo yokufaka kanye nemiphumela emithathu yokuhlanganisa ukudla, kodwa ayimele ukutholakala kwamanje, amanani noma imikhankaso yesitolo. Ekusetshenzisweni kwangempela, sebenzisa idatha ebuyiswe yisitolo esiqondiwe.

Ukusetshenziswa okuyisisekelo: Khiqiza izinhlelo ezintathu zokuhlanganisa ukudla

Isinyathelo sokuqala: Khetha okuncamelayo

Ngemva kokungena endaweni yokusebenza, ungaqala ngokukhetha okuthandwayo okufana nokuthi “Okulinganiselayo”. Okuncamelayo kuyabamba iqhaza ekunikezeni amaphuzu enhlanganisela, kodwa imiphumela isazoboshwa yisabelomali, amakhalori kanye nenhloso yamaprotheni.

Isinyathelo sesibili: Faka imibandela yokudla

Ungaqala ngale mibandela yesibonelo:

Idolobha: Shanghai
Isifunda sebhizinisi / Indawo ephawulekayo: People's Square
Isabelomali: 35 yuan
Umkhawulo wamakhalori: 700 kcal
Inhloso yamaprotheni: 35 g

Isinyathelo sesithathu: Buka imiphumela yokubala

Iseva izothola izitolo eziseduze, ifunde imenyu nedatha yokudla okunomsoco, bese ibuyisa izinhlobo ezintathu zezinhlelo:

1. Uhlelo A: Okukhethwa ngokulinganisela. Lunikeza ukudla okuyinhloko kanye nokudla okulula noma isiphuzo ngaphakathi kwemikhawulo yesabelomali namakhalori, futhi lubonisa amaprotheni, amaprotheni ngeyunithi yemali kanye nesizathu sokuncoma.
2. Uhlelo B: Ukwengeza amaprotheni. Lubeka phambili ukwandisa amaprotheni, kuyilapho luzama ukugcina imikhawulo yesabelomali namakhalori.
3. Uhlelo C: Inhlanganisela elula. Lunikeza inhlanganisela eshibhile kodwa ephelele, elungele izimo lapho izindleko nokusebenza kahle kokukhetha kubaluleke kakhulu.

Uma uqhathanisa izinhlelo, ungabheki amaprotheni esewonke kuphela. Ungasebenzisa futhi amaprotheni ngeyunithi yemali, isabelomali esisele, amakhalori asele kanye nomehluko wesaphulelo ukuze unqume ukuthi yimuphi umphumela ohambisana kangcono nesidingo samanje.

Isinyathelo sesine: Hlola uchungechunge lwezingcingo ze-MCP

Vula “Uchungechunge lwezingcingo ze-MCP” ukuze ubone isimo nesikhathi sokusebenza kwama-Tool ezitolo, amamenyu, ukudla okunomsoco, izaphulelo nemikhankaso. Lokhu kusiza ukunquma ukuthi izincomo zisekelwe kudatha ebuyiswe ngesikhathi sangempela noma ukuthi uhlelo lushintshele kusifinyezo sedemo ngenxa yokushoda kwe-Token noma ukungatholakali kwe-Tool.

Imiyalo yokuthuthukisa esetshenziswa njalo

• npm run dev: Qalisa i-Express API ne-Vite hot reload.
• npm run build: Yakha ingxenye engaphambili bese uhlanganisa iseva.
• npm start: Qalisa isevisi yokukhiqiza.
• npm test: Qalisa ukuhlolwa kwengqondo yokuhlanganisa kanye nokuhlaziya ukudla okunomsoco.
• npm run check: Qalisa ngokulandelana ukuhlolwa kwezinhlobo, ukuhlolwa kokuhlanganiswa kweseva kanye nokuhlolwa okujwayelekile.

Ngemva kokulungisa ukuhlaziya ukudla okunomsoco, ukumelwa kwemenyu noma imithetho yokuhlanganisa ukudla, kunconywa ukuthi okungenani usebenzise:

npm test
npm run check

Lokhu kusiza ukuthola kusenesikhathi amaphutha ezinhlobo, izinkinga zokuhlanganisa kanye nokubuyela emuva emikhawulweni yokuhlanganisa noma ekuhlaziyeni ukudla okunomsoco.

Ukusebenzisa i-Docker ekuthumeleni

Le phrojekthi inikeza indlela yokwakha nge-Docker. Qala ngokwakha isithombe:

docker build -t mcd-meal-mate .

Bese uqondanisa ichweba 8787 lomshini wendawo nesiqukathi, futhi udlulise i-Token ngokuguquguquka kwemvelo:

docker run --rm -p 8787:8787 \
  -e MCD_MCP_TOKEN="YOUR_MCD_MCP_TOKEN" \
  mcd-meal-mate

Ngemva kokuqalisa isiqukathi, ungavakashela http://localhost:8787. Uma ushiya MCD_MCP_TOKEN, uhlelo luzosebenzisa idatha yedemo.

Ukuqonda ukwakheka kwephrojekthi

Iphrojekthi ihlukanisa i-React frontend, isevisi ye-Express, izingcingo ze-MCP, ukuhlaziya ukudla okunomsoco kanye nokuhlela ukuhlanganisa ukudla kube amamojuli ahlukene:

src/
  App.tsx          I-workbench ye-React nokuxhumana okuphendulayo
  styles.css       Uhlelo lokubuka lwemenyu yehhovisi lokuhlela × irisidi
server/
  index.ts         I-Express API, ukuqinisekiswa kokufaka nezinsiza ezimile
  mcp.ts           Iklayenti le-MCP JSON-RPC, ukuhlelwa kwama-Tool nokwehla
  nutrition.ts     Ukuhlaziya umbhalo wokudla okunomsoco, ukumelwa kwemenyu nokuhlonza indima yomkhiqizo
  planner.ts       Imikhawulo yenhlanganisela, amaphuzu okuncamelayo nokukhetha izinhlelo ezintathu
  demo-data.ts     Isifinyezo sedemo esingadaluli ulwazi
  planner.test.ts  Ukuhlolwa kokudla okunomsoco nokuhlanganisa
shared/
  types.ts         Izinhlobo ezabiwe phakathi kwe-frontend ne-backend

server/mcp.ts iphethe ukuxhumana kwe-MCP JSON-RPC, ukuhlelwa kwama-Tool kanye nokwehla lapho kwehluleka; server/nutrition.ts iphethe ukumelwa kombhalo wokudla okunomsoco nemikhiqizo yemenyu; server/planner.ts isebenzisa imikhawulo yenhlanganisela, amaphuzu okuncamelayo kanye nokukhetha izinhlelo ezintathu. Izakhiwo zedatha ezisetshenziswa yi-frontend ne-backend zitholakala ku-shared/types.ts.

I-backend isebenzisa i-fetch yomdabu ukuxhumana ne-McDonald's MCP Streamable HTTP Server. Ekukhiqizeni, inqubo eyodwa ye-Express ihlinzeka kokubili nge-API nekhasi elimile, futhi igcina imiphumela yemenyu neyokudla okunomsoco kwimemori.

Ukusetshenziswa okuthuthukile nezincomo zokuthuthukisa

Qala ngokuhlola imibandela yemikhawulo

Uma ungatholi inhlanganisela oyilindele, qala uhlole ukuthi isabelomali, umkhawulo wamakhalori kanye nenhloso yamaprotheni akunzima kakhulu yini. Umhlanganisi wokudla kufanele ahlangabezane nemingcele eminingi ngesikhathi esisodwa, futhi imigomo ingase ingqubuzane. Ukwandisa isabelomali ngokufanele, ukuphakamisa umkhawulo wamakhalori noma ukwehlisa inhloso yamaprotheni kungasiza ekutholeni izinhlanganisela ezisebenzayo eziningi.

Hlukanisa idatha yesikhathi sangempela nesifinyezo sedemo

Lapho ulungisa izinkinga, qinisekisa ukuthi ikhasi libonisa yini “Idatha yedemo”, bese ubheka uchungechunge lwezingcingo ze-MCP. Uma kungekho Token, i-Tool ingatholakali okwesikhashana noma kusetshenziswa inguqulo ye-GitHub Pages esebenza ngaphambili kuphela, imiphumela ingase ivele kusifinyezo esingadaluli ulwazi.

Vikela iziqinisekiso zeseva

Ungafaki i-Token ohlangothini lwesiphequluli. Iphrojekthi isivele ifunda okuguquguqukayo kwemvelo isebenzisa isevisi ye-Express, bese iseva ibiza i-MCP, ngaleyo ndlela igweme ukuveza i-Token ku-frontend ngokwakheka kohlelo. Lapho uthumela kuseva noma esiqukathini, kufanele futhi ufake iziqinisekiso usebenzisa indlela ephephile yokuphatha okuguquguqukayo kwemvelo.

Ngemva kokushintsha ingqondo yokuhlela, sebenzisa ukuhlola okuphelele

Uma ulungise planner.ts, nutrition.ts noma izinhlobo ezabiwe, sebenzisa npm run check ukuhlola izinhlobo, ukuhlanganiswa kanye nokuhlolwa. Iphrojekthi inezivivinyo zokuhlanganisa nokuhlaziya ukudla okunomsoco, ezingasiza ukuqinisekisa ukuthi izinguquko azithinti ukuziphatha okukhona.

Funda izinto zokuhlanganisa

MCP_INTEGRATION.md esenqolobaneni irekhoda ama-Tool aphelele, ukuhamba kwezingcingo, inani lebhizinisi nemingcele yokuphepha; mcp-config.example.json inikeza isibonelo sokumisa esingadaluli ulwazi; workbuddy.md iqukethe umongo wokuxhumanisa we-WorkBuddy nemiyalo ephindaphindekayo. Lapho uxhuma enye i-Agent noma i-Skill, bhekisa kuqala kulawa mafayela.

Imingcele yokuphepha

• Inqolobane ayinayo i-Token yangempela, amaphasiwedi noma iziqinisekiso zama-akhawunti.
• I-MCP Token ifundwa kuphela kokuguquguqukayo kwemvelo kuseva.
• Iphrojekthi ayibizi ama-Tool oku-oda, ukukhokha, ilotho noma ukushintshanisa amaphuzu.
• Iseva ayigcini okokufaka komsebenzisi futhi ayakhi iphrofayela yomsebenzisi.
• Ukutholakala kokudla, amanani nemikhankaso kusekelwa eziteshini ezisemthethweni ze-McDonald's.
• Imiphumela yokuncoma ayithathwa njengeseluleko sezokwelapha, sokudla okunomsoco noma esinye iseluleko sobuchwepheshe.

Isifinyezo

I-M餐搭子 ihlanganisa ukusesha izitolo, imenyu yesikhathi sangempela, ukuhambisana nokudla okunomsoco, ulwazi lwezaphulelo kanye nokuhlela inhlanganisela kube inqubo eyodwa echazekayo yokuhlanganisa ukudla. Ngemva kokulungisa i-MCP Token, ingasebenzisa idatha yesitolo yamanje; uma ingekho i-Token, usengakwazi ukuzwa ukusebenzisana okuphelele ngesifinyezo esisuswe imininingwane ekukhombeni umuntu.

Ngemva kokuqeda ukufaka, ungaqala ngokusebenzisa izimo zesibonelo ukuze uqinisekise izinhlelo ezintathu, bese usebenzisa uchungechunge lwezingcingo ze-MCP ukuqinisekisa umthombo wedatha. Abathuthukisi bangase baqale ku-mcp.ts, nutrition.ts kanye no-planner.ts ukuze baqonde indlela ukuhlelwa kwedatha yesikhathi sangempela, ukumataniswa kokudla okunomsoco nokubalwa kwemikhawulo okwenziwa ngayo.