Mwongozo wa Msaidizi wa Kuokoa Pesa wa McDonald’s: Kuboresha Oda kwa MCP ya McDonald’s na Kukagua Hasara za Kuponi

Utangulizi wa mradi

Msaidizi wa Kuokoa Pesa wa McDonald’s (mcd-coupon-strategist) ni msaidizi wa gharama za kuagiza chakula aliyejengwa kwa kutumia MCP ya McDonald’s China. Hajibu tu swali la “niagize nini ili niokoe zaidi kwa oda hii”, bali pia huchanganua oda za awali na akiba ya kuponi, na kukuambia ni ofa zipi zinazokaribia kuisha na kugeuka kuwa hasara halisi.

Mradi hugawa tatizo la kuokoa pesa katika njia mbili:

• Uboreshaji wa muda mfupi: Husoma menyu ya sasa ya duka na kuponi zinazopatikana kwenye akaunti, huorodhesha bidhaa moja moja, seti, matumizi ya kuponi na mipango ya kuongeza bidhaa, kisha hutumia calculate-price kupata bei halisi ya kila chaguo.
• Ukaguzi wa muda mrefu: Hutumia order-list na query-my-coupons kuchanganua matumizi, wastani wa thamani ya oda, bidhaa zinazonunuliwa mara kwa mara na kuponi zinazokaribia kuisha.

Mtazamo mkuu wa mradi si kumsaidia mtumiaji kuendelea kutumia pesa tu, bali kwanza kutambua hasara zinazoendelea kutokea.

Vipengele muhimu na jinsi vinavyofanya kazi

Bei halisi kulingana na duka la sasa

Bei na upatikanaji wa bidhaa vinaweza kutofautiana kati ya maduka, kwa hiyo mradi hauhifadhi bei za menyu moja kwa moja. Chaguo zote hupelekwa kwenye calculate-price ya MCP ili zipangiwe bei, badala ya modeli kukisia kiasi.

Matokeo hayajumuishi tu malipo ya chini kabisa, bali pia yanaeleza tofauti ya bei inatokana na muundo wa seti, kuponi au bidhaa za kuongeza oda. Kwa mfano, seti ya bidhaa tatu inaweza kuwa nafuu kuliko kuagiza burger na chipsi kando; katika hali hiyo mfumo utapendekeza seti waziwazi na kueleza kiasi kilichookolewa.

Kutambua mitego ya kuongeza bidhaa

Kuponi si lazima ikufanye uokoe pesa kila inapotumika. Tuseme bidhaa ulizopanga kununua zinagharimu yuan 46.5, kisha unaongeza bidhaa ya yuan 3.5 ili kutumia ofa ya “punguza yuan 12 kwa matumizi ya yuan 50”; baada ya kutumia kuponi unalipa yuan 38. Ikiwa seti kama hiyo inagharimu yuan 33.5 pekee, mpango wa kuongeza bidhaa bado ni ghali kwa yuan 4.5.

Mradi hulinganisha malipo ya mwisho, badala ya kuangalia tu kiasi kilichoandikwa kwenye kuponi. Isipokuwa bidhaa iliyoongezwa ni kitu ambacho mtumiaji alikuwa akihitaji, mfumo utashauri kuepuka mpango huo.

Kukokotoa gharama fiche ya kuponi

“Gharama fiche ya kuponi” ni thamani ya ofa inayokaribia kuisha lakini bado haijatumika. Kwa kuwa kuponi zinazorejeshwa na MCP huenda zikawa na majina pekee, mradi hulinganisha menyu ya duka la sasa ili kukadiria thamani yake:

• Kuponi ya punguzo kwa kiwango cha matumizi: “punguza yuan 12 kwa matumizi ya yuan 50” hukokotolewa moja kwa moja kuwa yuan 12.
• Kuponi ya nunua moja pata moja: “nunua chipsi za kati moja upate moja” hukokotolewa kwa kutumia bei ya menyu ya bidhaa husika.
• Kuponi ya bei maalum: “kahawa ya barafu ya ukubwa wa kati kwa yuan 9.9” hukokotolewa kama bei ya kawaida ya menyu ukitoa yuan 9.9.

Ikiwa bidhaa inayohusika haipatikani kwenye menyu, mradi huweka thamani ya kuponi kuwa 0 na kuonyesha hilo kwenye ripoti. Hautumii makadirio yanayoonekana kuwa ya busara bila msingi.

Kuchanganua tabia za matumizi ya muda mrefu

Moduli ya ukaguzi inaweza kujumlisha idadi ya oda, matumizi yote, wastani wa thamani ya oda na bidhaa zinazonunuliwa mara kwa mara kutoka kwenye oda za awali, kisha kutoa mapendekezo ya kimuundo. Kwa mfano, ikiwa burger ileile imeagizwa kando mara nyingi, mfumo unaweza kupendekeza ulinganishe na seti husika, kwa kuwa kubadili kuwa seti kunaweza kupunguza matumizi kila mara. Oda zilizorejeshewa fedha zote huchujwa ili zisiingizwe kwenye matumizi.

Maandalizi

Kabla ya kutumia vipengele vya MCP mtandaoni, andaa mazingira yafuatayo:

• Programu inayounga mkono viunganishi maalum vya MCP, kama WorkBuddy iliyoonyeshwa kwenye README.
• Tokeni iliyotolewa na jukwaa la wazi la MCP la McDonald’s.
• Ikiwa unahitaji kuendesha majaribio ya ndani, Python 3.8 au toleo la juu zaidi.

Majaribio manne ya ndani hayahitaji tokeni ya MCP; hata hivyo, kuangalia menyu halisi, kuponi za akaunti na oda za awali kunahitaji tokeni halali.

Kuomba na kusanidi tokeni ya MCP

Hatua ya kwanza: Omba tokeni

Tembelea jukwaa la wazi la MCP la McDonald’s, ingia kwa kutumia nambari ya simu, kisha washa na unakili tokeni ya MCP kwenye dashibodi.

Hatua ya pili: Unda usanidi wa MCP

Hifadhi ya mradi inatoa faili la usanidi lililoondolewa taarifa nyeti, mcp-config.example.json. Muundo wa usanidi ni huu:

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

Badilisha ${MCD_MCP_TOKEN} kwa tokeni yako, kisha uiandike kwenye usanidi wa MCP Client. Usitume tokeni halisi kwenye hifadhi ya umma, wala usiionyeshe kwenye picha za skrini, kumbukumbu au ripoti za matatizo.

Hatua ya tatu: Washa kwenye WorkBuddy

1. Fungua WorkBuddy, nenda kwenye “Wataalamu, ujuzi, viunganishi” upande wa kushoto, kisha uchague kichupo cha “Viunganishi”.
2. Bofya “Kiunganishi maalum”, kisha uchague “Sasisha MCP”.
3. Bandika usanidi wa JSON wenye tokeni iliyobadilishwa, kisha uhifadhi.
4. Rudi kwenye orodha ya viunganishi maalum na uweke mcd-mcp kuwa imewashwa.

Jinsi ya kutumia kwa msingi

Mfano wa kwanza: Tafuta mchanganyiko kulingana na bajeti

Chagua duka kwanza, kisha eleza kwa uwazi bajeti, aina za chakula unachohitaji na idadi ya chaguo za kulinganisha. Unaweza kutuma ujumbe huu moja kwa moja:

Ninaagiza chakula cha kusafirishwa kutoka McDonald’s. Baada ya kuchagua duka, nisaidie kuhesabu:
Nina kuponi, nataka burger moja + chipsi moja + kinywaji kimoja, bajeti yangu ni yuan 40,
niagize nini ili niokoe zaidi? Nipe mipango miwili ya kulinganisha.

Msaidizi atasoma menyu ya sasa ya duka na kuponi zinazopatikana, atatengeneza mchanganyiko wa chaguo, kisha atatumia MCP kukokotoa bei halisi. Matokeo ya kawaida yanaweza kupendekeza seti ya burger ya kuku yenye pilipili na bidhaa mbili nyingine kwa yuan 33.5, na kuilinganisha na mpango wa kuagiza burger na chipsi kando kwa yuan 37.

Mfano wa pili: Weka mipaka ya chakula kikuu na cha kuambatanisha

Bajeti yangu ni yuan 35, nataka chakula kikuu cha kuku na chakula kimoja cha kuambatanisha.
Tafadhali angalia bidhaa zinazopatikana katika duka la sasa, kisha toa chaguo linalopendekezwa,
mbadala na lisilopendekezwa, na ueleze kwa nini kila chaguo ni nafuu au ghali zaidi.

Aina hii ya ombi humwezesha msaidizi kuzingatia kwa pamoja bajeti, hitaji la kushiba na aina ya bidhaa, badala ya kupendekeza tu chaguo lenye bei ya chini kabisa ambalo huenda lisikidhi mahitaji.

Mfano wa tatu: Amua ikiwa kuongeza bidhaa kuna faida

Nina kuponi ya “punguza yuan 12 kwa matumizi ya yuan 50”.
Kwa kuzingatia mahitaji yangu ya sasa ya ununuzi, linganisha malipo ya mwisho ya kununua moja kwa moja,
kuongeza bidhaa ili kutumia kuponi na kubadili kuwa seti.
Ikiwa kuongeza bidhaa kunafanya gharama iwe kubwa, nikumbushe waziwazi.

Wakati wa kulinganisha, zingatia hasa malipo ya mwisho, si kiasi kilichopunguzwa kwenye kuponi. Mradi hujumuisha gharama ya bidhaa zilizoongezwa na kuonyesha ikiwa seti ni yenye faida zaidi kuliko kuongeza bidhaa.

Mfano wa nne: Kagua matumizi ya hivi karibuni

Tafadhali chambua oda zangu za McDonald’s za miezi michache iliyopita:
Hesabu idadi ya oda, matumizi yote na wastani wa thamani ya oda, kisha utambue bidhaa zinazonunuliwa mara kwa mara;
pia orodhesha kuponi zinazokaribia kuisha, thamani yake inayokadiriwa na siku zilizobaki,
na mwisho uniambie ni jambo gani ninalopaswa kushughulikia kwanza mwezi huu.

Hili litaanzisha njia ya ukaguzi wa muda mrefu. Matokeo yatazingatia thamani yote ya kuponi zinazokaribia kuisha, tabia za matumizi na mapendekezo ya kimuundo yanayoweza kutekelezwa, badala ya bei ya chini ya oda moja pekee.

Kuendesha majaribio ya ndani

Baada ya kupata msimbo wa chanzo wa mradi, tumia Python 3.8 au toleo la juu zaidi kuendesha majaribio yafuatayo kwenye saraka kuu ya hifadhi:

python src/test_saver.py
python src/test_auditor.py
python src/test_adapter.py
python src/test_order_adapter.py

• test_saver.py: Huthibitisha uorodheshaji, upangaji na utambuzi wa mitego ya kuongeza bidhaa.
• test_auditor.py: Huthibitisha gharama fiche, tabia za matumizi na mipaka ya tarehe.
• test_adapter.py: Huthibitisha ubadilishaji wa vitengo na uchanganuzi wa majibu ya MCP.
• test_order_adapter.py: Huthibitisha uchanganuzi wa oda na kuponi, uchujaji wa marejesho ya fedha na ukadiriaji wa thamani ya kuponi.

Majaribio haya manne yote yanaendeshwa ndani pekee na hayahitaji kusanidi tokeni ya MCP. README haijaorodhesha amri za ziada za kusakinisha vifurushi, kwa hiyo fuata msimbo halisi wa hifadhi na nyaraka za muunganisho.

Kuelewa usanifu wa mradi

Mradi hutenganisha majibu ghafi ya MCP na algoriti za biashara kupitia safu ya adapta. Moduli kuu ni hizi:

• src/saver.py: Husimamia njia ya kuokoa pesa kwa oda moja, huorodhesha mchanganyiko wa chaguo na kulinganisha malipo halisi.
• src/auditor.py: Husimamia ukaguzi wa muda mrefu, hukokotoa gharama fiche ya kuponi na kuunda wasifu wa matumizi.
• src/mcd_adapter.py: Husimamia ulinganifu wa sehemu za data, uchujaji wa marejesho ya fedha, utafutaji wa thamani ya kuponi kwenye menyu na ubadilishaji pekee wa “senti kuwa yuan”.
• MCP_INTEGRATION.md: Hurekodi MCP Server, zana, mtiririko wa miito na mkataba wa miito iliyojaribiwa.
• SKILL.md: Hueleza ufafanuzi wa Skill na mtiririko mzima wa kazi.

Safu ya algoriti haigusani moja kwa moja na majibu ghafi ya MCP, jambo linalosaidia kuepuka tofauti za sehemu za data na mkanganyiko wa vitengo vya fedha. Zingatia hasa kuwa kiolesura kimoja kinaweza kutumia “senti” na kingine “yuan”; mwelekeo huu unapaswa kushughulikiwa kwa pamoja kupitia safu ya adapta.

Mbinu za matumizi ya juu

Eleza kwanza “utakula nini”, kisha linganisha bei

Bei ya chini si lazima iwe chaguo linalofaa. Kwenye ombi, taja chakula kikuu, chakula cha kuambatanisha, kinywaji, idadi ya watu, bajeti na mahitaji ya chini, ili mfumo ulinganishe chaguo zinazokidhi mahitaji sawa.

Omba maelezo ya chanzo cha akiba

Unaweza kuomba ionyeshe “imetumia kuponi ipi, imebadilisha kuwa seti gani, imeongeza bidhaa gani na imeokoa kiasi gani ikilinganishwa na chaguo la msingi”. Hivyo hutapata tu hitimisho, bali pia utaweza kuhukumu ikiwa pendekezo linaendana na mahitaji yako halisi.

Tenganisha thamani iliyo kwenye kuponi na faida halisi

Kuponi yenye thamani ya kinadharia ya yuan 12 haimaanishi oda ya sasa itaokoa yuan 12. Kiwango cha chini cha matumizi, duka linalokubali, bidhaa zinazotumika na gharama ya kuongeza bidhaa vinaweza kubadilisha faida halisi. Angalia kwa pamoja thamani ya kuponi na malipo ya mwisho.

Shughulikia kwanza kuponi zinazokaribia kuisha na zenye thamani inayojulikana

Wakati wa ukaguzi wa muda mrefu, unaweza kupanga kwa siku zilizobaki na thamani inayoweza kuthibitishwa. Kuponi ambazo bei yake ya awali haiwezi kutafutwa kwenye menyu zinapaswa kuendelea kuonyeshwa kama zisizojulikana au 0; usikisie kiasi ili tu kukamilisha ripoti.

Tumia data ya duka la sasa kila wakati

Usitumie tena bei kutoka duka lingine au oda za awali. Menyu, upatikanaji wa bidhaa na maduka yanayokubali kuponi vinaweza kubadilika; kila uamuzi unapaswa kutegemea matokeo rasmi ya wakati huo kutoka duka la sasa.

Linda vitambulisho vya akaunti

Inashauriwa kila mara kuhifadhi tokeni kwa kutumia vigezo vya mazingira au usanidi salama wa programu. Unaposhiriki usanidi hadharani, hifadhi tu kishikilia nafasi kama ${MCD_MCP_TOKEN}.

Mipaka ya muundo na tahadhari

• Bei zote zinapaswa kutegemea jibu halisi la calculate-price ya MCP.
• Thamani ya kuponi isiyoweza kuthibitishwa kwenye menyu iwekwe kuwa 0 na ionyeshwe hivyo; isikadiriwe.
• Oda zilizorejeshewa fedha hazihesabiwi kwenye matumizi.
• Mradi hauwahimizi watumiaji kununua bidhaa zisizo za lazima ili kutumia kuponi.
• Chakula, bei, upatikanaji wa bidhaa na maduka yanayokubali kuponi vinategemea matokeo ya wakati halisi kutoka njia rasmi za McDonald’s.
• Mradi huu ni kazi ya mashindano iliyotengenezwa kwa kujitegemea, si bidhaa rasmi ya McDonald’s.
• Matokeo ni ya kusaidia maamuzi ya matumizi pekee; hayajumuishi ushauri wa kitabibu, lishe au ushauri mwingine wa kitaalamu.

Muhtasari

Msaidizi wa Kuokoa Pesa wa McDonald’s huunganisha uboreshaji wa oda wa wakati halisi na ukaguzi wa matumizi ya muda mrefu: kwa muda mfupi hutumia bei halisi kuchagua mchanganyiko wa seti, bidhaa moja moja na kuponi; kwa muda mrefu hutumia oda na akiba ya kuponi kutambua hasara fiche kama wastani mkubwa wa thamani ya oda, kuagiza bidhaa kando mara kwa mara na kuponi kuisha.

Baada ya kusanidi tokeni ya MCP, anza kwa ombi la kuagiza lenye bajeti na mahitaji ya chakula, kisha hatua kwa hatua jaribu ulinganisho wa kuongeza bidhaa na ukaguzi wa matumizi ya kila mwezi. Kwa wasanidi programu, mgawanyo wa saver.py, auditor.py na mcd_adapter.py pia unatoa rejeleo wazi la kuandaa njia mbili za MCP.