Isifundo se-Oh-My-McDonald: Buza nge-McDonald’s nge-AI, qhathanisa amanani futhi udale izithombe ze-voxel

Iyini i-Oh-My-McDonald

Oh-My-McDonald iyi-AI Skill eqhutshwa ingxoxo, esekelwe ku-MCP esemthethweni yakwaMcDonald’s. Ungatshela i-AI ngolimi olujwayelekile ngesabelomali, ukunambitheka kanye nezinto ongazifuni, bese ibheka ukudla kwangempela; ungaphinda uqhathanise amanani ezitolo, ubuke amakhuphoni nemikhankaso, ubale idatha yokudla okunomsoco, futhi ngemva kokuqinisekisa ugcine ukudla okudlile nezitolo ozivakashele.

Iphrojekthi ithola idatha yebhizinisi nge-MCP esemthethweni yakwaMcDonald’s, bese isebenzisa imibhalo ye-Python yendawo ukucubungula idatha, ukugcina amarekhodi nokunikezela izithombe. Ayidingi isixhumi esibonakalayo sewebhu, futhi ayincikile ku-OpenAI API noma kwamanye ama-API akhiqiza izithombe.

Vakashela inqolobane ye-Oh-My-McDonald ku-GitHub

Yiziphi izinkinga iphrojekthi engazixazulula

• Ukubheka ukudla, izitolo, amanani, izaphulelo kanye nolwazi lokudla okunomsoco engxoxweni eyodwa.
• Ukukhetha phakathi kokudla kwangempela okubuyiswe yi-MCP ngokwesabelomali, ukunambitheka kanye nezinto ongazifuni.
• Ukuqhathanisa intengo yomkhiqizo ofanayo, ngosayizi ofanayo, ezitolo ezikhethiwe ezingafika kwezintathu.
• Ukubuka iphakethe lamakhuphoni omuntu siqu, izikhathi zokuphelelwa yisikhathi kanye nemikhankaso eshicilelwe.
• Ukubala ngokunembile amandla, amaprotheni, amafutha, ama-carbohydrate, i-sodium kanye ne-calcium yokudla okufanayo ncamashi.
• Ukugcina ikhathalogi yokudla namarekhodi okuvakashela izitolo ngemva kokuqinisekisa ukuthi ukudla kudliwe noma isitolo sivakashelwe.
• Ukuguqula imiphumela yophenyo ibe yizithombe ze-PNG zesitayela se-voxel ezilula ukuzibuka nokwabelana ngazo.

Izimo ezine zokubonisa nge-voxel

Iphrojekthi ine-renderer ye-Python voxel eyakhelwe ngaphakathi. Njengamanje iqukethe amamodeli angu-43 e-voxel amakhulu, futhi ikhiqiza izithombe ngokomthetho wamaphikseli angu-8 ngeseli ngalinye.

Ikhathalogi yokudla

Ikhathalogi yokudla isebenzisa amahholo ahlukaniswe izindawo, izindlela ezijikayo kanye nezitebele zokudla ukukhombisa inqubekelaphambili yokuhlola. Ukudla okudliwe ngempela futhi kwaqinisekiswa kuphela yikho okukhanyiswayo; okungakaqinisekiswa kuhlala kumpunga.

Ikhalenda lezaphulelo

Ikhalenda lezaphulelo libala ngokwezinsuku zokusebenza zamakhuphoni omuntu siqu, ligcizelele amakhuphoni asebenza namuhla, lawo azophelelwa yisikhathi maduze kanye nemikhankaso eshicilelwe. Imininingwane ephelele ingafakwa emakhasini alandelayo ukuze kugwenywe ukuminyanisa yonke into esithombeni esisodwa.

Ukuqhathanisa amanani ezitolo

Isimo sokuqhathanisa amanani sihlela izitolo ezikhethiwe emgwaqweni we-voxel, bese sibonisa intengo ehambisanayo emnyango ngamunye. Lo mgwaqo usetshenziselwa ukubonisa idatha kuphela; awumele imigwaqo yangempela noma ubudlelwano bendawo phakathi kwezitolo.

Etafuleni lokudla okunomsoco

Isimo sokudla okunomsoco sibeka ukudla kwalokhu kudla epuletini elilodwa, sisebenzise irisidi ukubonisa idatha yokudla okunomsoco. Imifino, izithelo kanye nemikhiqizo yobisi kuyiziphakamiso zokwengeza ngaphandle kokudla, futhi akufakwa esibalweni esiphelele sokudla okusepuletini.

Ukulungiselela ngaphambi kokufaka

Ngaphambi kokuqala, qinisekisa ukuthi ikhompuyutha yakho ihlangabezana nale mibandela:

• Python 3.11 noma inguqulo ephakeme.
• Ukwazi ukudala nokusebenzisa i-environment ye-Python ebonakalayo ngendlela evamile.
• Ukufaka ifonti esekela isiShayina; kunconywa i-Noto Sans CJK.
• Uma kudingeka ukusesha kwesikhathi sangempela, lungisa imininingwane yokufinyelela ku-MCP esemthethweni yakwaMcDonald’s.

Okuncikile okuyinhloko kwephrojekthi yi-Pillow >=10,<13 kanye ne-NumPy >=1.24,<3; konke okuncikile kubhalwe ku-requirements.txt.

Isinyathelo sokuqala: Klona iphrojekthi

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

Isinyathelo sesibili: Dala i-environment ebonakalayo

Ku-Linux noma ku-macOS sebenzisa:

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

Abasebenzisi be-Windows PowerShell sebenzisa:

.venv\Scripts\Activate.ps1

Isinyathelo sesithathu: Faka okuncikile

python -m pip install -r requirements.txt

Kuyanconywa ukuthi uhlale ufaka okuncikile ku-environment ebonakalayo esivele ivuliwe, ukuze ugweme ukungqubuzana namanye amaphakheji e-Python akusistimu.

Isinyathelo sesine: Lungisa ifonti yesiShayina

Izithombe ze-voxel ziqukethe amagama okudla, amagama ezitolo kanye nezihloko zezaphulelo ngesiShayina, ngakho kudingeka ifonti yesiShayina esebenzayo. Ngemva kokufaka i-Noto Sans CJK, ungasebenzisa i-OMM_FONT ukuze ucacise indlela eya kufayela lefonti.

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

Shintsha indlela eyisibonelo ufake indlela eya kufayela lefonti elikhona ngempela kule khompuyutha. Uma isiShayina singabonakali kahle esithombeni, qala uhlole le variable ye-environment nendlela yefonti.

Isinyathelo sesihlanu: Buka usizo lwemiyalo

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

Lo myalo uzobonisa imiyalo engaphansi namapharamitha anikezwa yimibhalo esizayo yendawo. Incazelo ephelele itholakala ku-oh-my-mcdonald/references/commands.md ngaphakathi kwenqolobane.

Xhuma ku-MCP esemthethweni yakwaMcDonald’s

Thola i-MCP Token

Vakashelaikhonsoli ye-McDonald’s MCP, bese ulandela imiyalelo esekhasini elisemthethweni ukuze uthole i-MCP Token. Imininingwane yokufinyelela kufanele igcinwe ku-environment yendawo noma ekucushweni kwe-Codex; ungabhali i-Token yangempela kumafayela ephrojekthi noma uyithumele enqolobaneni ye-Git.

Lungisa i-Token nge-variable ye-environment

export MCD_MCP_TOKEN="YOUR_MCD_MCP_TOKEN"

Funda imininingwane yokufinyelela ekucushweni kwe-Codex

Uma ifayela lokucushwa lendawo selivele liqukethe ukucushwa kwe-mcd-mcp, ungasebenzisa i---codex-config ukuze ucacise ifayela:

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

Zombili lezi zindlela zifunda imininingwane yokufinyelela kule khompuyutha kuphela. Inqubo ephelele yokuxhuma ingatholakala ku-MCP_INTEGRATION.md esimpandeni senqolobane.

Amathuluzi e-MCP asetshenziswa yiphrojekthi

• query-nearby-stores: Ukusesha izitolo eziseduze.
• query-meals: Ukusesha ukudla.
• query-meal-detail: Ukusesha imininingwane yokudla.
• query-store-coupons: Ukusesha izaphulelo zesitolo.
• query-my-coupons: Ukusesha iphakethe lamakhuphoni omsebenzisi.
• calculate-price: Ukubala intengo yomkhiqizo ocacisiwe.
• campaign-calendar: Ukusesha ikhalenda lemikhankaso.
• list-nutrition-foods: Ukuthola idatha yokudla edingekayo ekubaleni ukudla okunomsoco.
• order-list: Ukusesha amarekhodi ama-oda.

Ukusetshenziswa okuyisisekelo kokuqala: Sesha izitolo

Umyalo ongezansi usesha izitolo ezise-Wuhan ezinegama noma indawo ehambisana no-“东澜岸”:

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

Ngemva kokuthola imiphumela yezitolo, ungasebenzisa i-ID yesitolo esebenzayo ukuze uqhubeke nokusesha imininingwane yokudla nezintengo.

Ukusetshenziswa okuyisisekelo kwesibili: Sesha imininingwane yokudla

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

• --store isetshenziselwa ukucacisa i-ID yesitolo.
• --code isetshenziselwa ukucacisa ikhodi yokudla.

Ama-ID akulesi sibonelo asetshenziselwa ukuchaza ifomethi yamapharamitha kuphela. Ekusetshenzisweni kwangempela, sebenzisa i-ID yesitolo nekhodi yokudla esebenzayo ebuyiswe yimiphumela yamanje ye-MCP.

Ukusetshenziswa okuyisisekelo kwesithathu: Sesha intengo yebhasikidi

Okuqukethwe kwebhasikidi kunikezwa ngefayela le-JSON, futhi iphrojekthi ibala intengo ngokwesitolo esicacisiwe nohlelo lokuhlola lwamanje.

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

Lapho uqhathanisa amanani ezitolo, qinisekisa ukuthi uqhathanisa umkhiqizo ofanayo nosayizi ofanayo. Iphrojekthi iqhathanisa izitolo ezikhethiwe ezingafika kwezintathu kuphela, futhi ayiqageli amanani ezinye izitolo ngokusekelwe emiphumeleni yezitolo ezimbalwa.

Ukusetshenziswa okuyisisekelo kwesine: Buka amamodeli e-voxel ungaxhunyiwe ku-inthanethi

Uma okwamanje ungenayo i-MCP Token, ungaqala uqinisekise indawo yokunikezela yendawo bese ubuka amamodeli akhelwe ngaphakathi:

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

Imiphumela ekhiqiziwe izobhalwa ku-output. Lesi sinyathelo sifanele ukuhlola ukuthi i-Pillow, i-NumPy kanye nefonti yesiShayina kulungiswe kahle yini.

Ukusebenzisa i-Skill eklayentini le-AI

Iphrojekthi inikeza i-oh-my-mcdonald/SKILL.md, echazela amaklayenti e-AI asekela ama-Skill ngamakhono ephrojekthi, inqubo yokusebenza kanye nemikhawulo. Iklayenti kufanele futhi libe namandla okuxhuma ku-MCP nawokusebenzisa imiyalo yendawo.

Inqubo ejwayelekile imi kanje:

1. Umsebenzisi ubeka izidingo zesabelomali, ukunambitheka, isitolo, izaphulelo noma ukudla okunomsoco ngolimi olujwayelekile.
2. I-AI ikhetha ithuluzi le-MCP elifanele ukuze ithole idatha yebhizinisi yangempela.
3. I-AI ihlunga imiphumela ebuyisiwe ngokwesabelomali nezinto ezingafunwa.
4. Ibiza imibhalo ye-Python yendawo lapho kudingeka ukuze icubungule idatha.
5. Lapho kudingeka ukuboniswa, i-renderer yendawo ikhiqiza i-PNG.
6. Uma kuhileleka amarekhodi okudla noma okuvakashela izitolo, ilinda ukuqinisekiswa okucacile komsebenzisi ngaphambi kokubhala amarekhodi.

Ungenza izicelo ezifana nalezi ku-AI:

• Namuhla nginesabelomali samayuan angu-35, futhi angifuni okubabayo. Yini oyincomayo?
• Khetha ngokungahleliwe ukudla okukodwa phakathi kokudla kwangempela okuhambisana nemibandela.
• Qhathanisa intengo yale sethi ezitolo ezintathu eziseduze.
• Buka amakhuphoni engingawasebenzisa namuhla kanye nemikhankaso yakamuva.
• Bala amandla namaprotheni alokhu kudla.
• Ngiyaqinisekisa ukuthi ngisanda kudla le hamburger. Ngisize ngiyirekhode.
• Yenza ikhathalogi yesithombe yokudla engikudlile.

Ukudla okuzokhethwa kufanele kuvele emiphumeleni yophenyo ye-MCP; i-AI akufanele ikusungule. Ekukhetheni okungahleliwe okukodwa, kungasetshenziswa inhlanganisela yokudla okuzokhethwa engafika kweziyisithupha.

Amasu athuthukile nemigomo yokusebenzisa

Qala ngokucacisa isitolo, umkhiqizo nosayizi

Intengo ithintwa isitolo, usayizi womkhiqizo kanye nohlelo lwezaphulelo. Ngaphambi kokuqhathanisa, lungisa umkhiqizo nosayizi, futhi wenze i-AI ibhale ngokucacile izitolo ezikhethiwe. Ngale ndlela kuphela imiphumela engaba nokufaniswa okufanele.

Phatha ngokuqinile ukushoda kwedatha yokudla okunomsoco

Ukubala ukudla okunomsoco kusebenzisa kuphela ukudla okuhambisana ncamashi. Uma ezinye izinkambu zokudla okunomsoco zingekho, phawula izinto ezingekho ngokwehlukana; ungaphathi inani elingekho njengeqanda, futhi ungasebenzisi umkhiqizo ofana ngegama kodwa ongakaqinisekiswa.

Hlukanisa izibalo zokudla kwangaphakathi neziphakamiso zangaphandle

Etafuleni lokudla okunomsoco kungaboniswa iziphakamiso ezengeziwe ezifana nemifino, izithelo nemikhiqizo yobisi, kodwa inani lokudla okunomsoco kwalokhu kudla libala kuphela ukudla okusepuletini. Lapho uhumusha isithombe esikhiqiziwe, izinto ezibhekiselwe kuzo ngaphandle kokudla akufanele zifakwe esibalweni esiphelele.

Cela ukuqinisekiswa komsebenzisi ngaphambi kokugcina irekhodi

Amarekhodi ama-oda angaba ulwazi olulindele ukuqinisekiswa kuphela; awakwazi ukufakazela ngokuqondile ukuthi umsebenzisi usidlile isidlo esithile. Iphrojekthi kufanele igcine irekhodi futhi ikhanyise ikhathalogi kuphela ngemva kokuba umsebenzisi eqinisekise ngokucacile ukuthi usidlile. Umgomo ofanayo uyasebenza nakumarekhodi okuvakashela izitolo.

Qonda kahle ikhalenda lezaphulelo

Ikhalenda libala inani lamakhuphoni ngokwezinsuku zokusebenza kwephakethe lamakhuphoni omuntu siqu. Ukuthi ikhuphoni lingasetshenziswa yini ngesikhathi esithile, esitolo esithile noma emkhiqizweni othile kufanele kusanqunywe yizimo eziqondile ezibuyiswe yi-MCP.

Vikela imininingwane yokufinyelela yendawo

Okuncanyelwayo ukufunda i-Token nge-variable ye-environment MCD_MCP_TOKEN noma ekucushweni kwe-Codex kwale khompuyutha. Ungabhali imininingwane yokufinyelela emibhalweni, kuma-JSON ayizibonelo, ezithombeni-skrini noma kumafayela alawulwa yinguqulo.

Ukuqalisa ukuhlolwa okuzenzakalelayo

Le phrojekthi isebenzisa i-Python unittest, futhi ungayiqalisa empandeni yenqolobane:

python -m unittest discover -s tests -v

I-README ibhala ukuthi kunezivivinyo ezikhona ezingu-51, ezisebenzisa idatha yokwenziwa ukuqinisekisa ukucutshungulwa kwebhizinisi, okukhiphayo kanye nengqondo yokunikezela. Isimo sokuqinisekisa semibuzo yangempela ye-MCP kanye nemikhawulo kubhalwe ku-docs/VALIDATION.md.

Imingcele yokusetshenziswa okufanele uyazi

• Le phrojekthi ayisekeli ukubeka ama-oda ngokuzenzakalelayo, ukukhokha noma ukulanda amakhuphoni.
• Le phrojekthi ayinikezi ukuvumelanisa kwamafu noma ukuhlola okuqhubekayo kwangemuva.
• Ukuqhathaniswa kwamanani kufinyelela ezitolo ezintathu ezikhethiwe kuphela, futhi kubhekene nomkhiqizo ofanayo, usayizi ofanayo kanye nohlelo lokuhlola lwamanje.
• Umgwaqo we-voxel uyisimo esichazayo kuphela, futhi awufaki imigwaqo yangempela noma ubudlelwano bezindawo.
• Idatha yangempela ye-MCP ekubukeni kuqala iyisithombe-sikhathi sosuku oluthile, futhi ayimele imiphumela yesikhathi sangempela yakamuva.
• Amarekhodi okudla kanye namarekhodi okuvakashela izindawo kumele aqinisekiswe umsebenzisi.

Ukubuka ngokushesha kwesakhiwo senqolobane

• oh-my-mcdonald/SKILL.md: Ifayela elichaza i-Skill leklayenti le-AI.
• oh-my-mcdonald/scripts/oh_my_mcdonald.py: Isikripthi sosizo sendawo kanye nendawo eyinhloko yokungena kwemiyalo.
• oh-my-mcdonald/references/commands.md: Inkomba enemininingwane yemiyalo.
• docs/images/: Izithombe zokubuka kuqala kwesimo.
• docs/VALIDATION.md: Imiphumela yokuqinisekisa yemibuzo yangempela kanye nemikhawulo.
• examples/basket.json: Isibonelo se-JSON sebhasikidi lokuthenga.
• MCP_INTEGRATION.md: Incazelo yokuxhumana ne-MCP kanye nenqubo yokuyisebenzisa.
• tests/: Ukuhlolwa okuzenzakalelayo.

Isiphetho

Oh-My-McDonald ihlanganisa i-MCP esemthethweni yakwaMcDonald's, ukuxhumana ngolimi lwemvelo kanye nokunikezelwa kwendawo kwe-voxel, okusiza ekukhetheni ukudla, ekuqhathaniseni amanani nasekuhlaziyeni umsoco, futhi yakhe amarekhodi okuhlola komuntu siqu aqinisekisiwe. Kunconywa ukuthi uqale ngokuqedela ukunikezelwa kwemodeli engaxhunyiwe ku-inthanethi kanye nokuhlolwa, bese ulungiselela i-MCP Token; lapho kuhileleka amanani, izaphulelo noma umsoco, hlala usebenzisa idatha yangempela ebuyiswe yi-MCP yamanje njengesisekelo.

Le phrojekthi ingumthombo ovulekile ngaphansi kwe-MIT License. Ungabika izinkinga nge-GitHub Issues, noma uthumele i-Pull Request ukuze ubambe iqhaza ekuyithuthukiseni.