دليل مساعد التوفير فـ ماكدو: استعمل MCP ديال ماكدونالدز باش تحسّن الطلب وتدقّق فخسائر الكوبونات

تقديم المشروع

مساعد التوفير فـ ماكدو (mcd-coupon-strategist) هو مساعد لحساب كلفة الطلب، مبني على MCP ديال ماكدونالدز الصين. ما كيكتفيش يجاوبك على سؤال «شنو نطلب باش نخلّص أقل؟»، بل كيحلل حتى الطلبات السابقة ومخزون الكوبونات، وكيبيّن ليك شنو هي العروض اللي قربات تسالي وولات كتتحول لخسارة فعلية.

المشروع كيفرق مشكل التوفير لجوج مسارات:

• التحسين على المدى القصير: كيقرأ منيو المطعم الحالي والكوبونات المتاحة فالحساب، وكيعدّد المنتجات المفردة، الوجبات، استعمال الكوبونات وخيارات الزيادة، ومن بعد كيستعمل calculate-price باش يجيب الثمن الحقيقي ديال كل خيار.
• التدقيق على المدى الطويل: باستعمال order-list وquery-my-coupons كيحلل المصاريف، متوسط قيمة الطلب، المنتجات اللي كتعاود بزاف، والكوبونات اللي قربات تسالي.

الفكرة الأساسية ديال المشروع ماشي غير يعاون المستخدم يكمل يستهلك، ولكن الأول يلقا الخسائر اللي واقعة دابا.

الوظائف الأساسية وكيفاش كيخدم

حساب الثمن الحقيقي ديال المطعم الحالي

الأثمنة وحالة التوفر يقدرو يختلفو من مطعم لمطعم، وداكشي علاش المشروع ما كيحطش أثمنة المنيو بشكل ثابت. فالمرحلة الأخيرة، كل اقتراح كيتحسب عن طريق calculate-price ديال MCP، وما كيخليش النموذج يخمّن المبلغ.

النتيجة ما كتتضمنش غير أقل مبلغ خاص يتخلّص، بل كتشرح حتى واش الفرق جا من تركيب الوجبة، الكوبون ولا المنتجات المضافة. مثلا، يقدر طقم من ثلاثة منتجات يكون أرخص من هامبرغر وبطاطا مطلوبين بوحدهم؛ فهاد الحالة النظام كيوصي بالطقم وكيشرح شحال غادي توفّر.

اكتشاف فخاخ الزيادة باش تستعمل الكوبون

استعمال الكوبون ما كيضمنش ديما التوفير. نفترضو أن المنتجات اللي كان ناوي يشري المستخدم ثمنها 46.5 يوان، وزاد منتوج بثمن 3.5 يوان باش يستعمل عرض «نقص 12 من بعد ما توصل لـ 50»، ومن بعد ولى المبلغ المؤدى 38 يوان؛ إلا كانت وجبة من نفس النوع كتكلّف غير 33.5 يوان، فالخيار ديال الزيادة باقي أغلى بـ 4.5 يوان.

المشروع كيقارن المبلغ النهائي المؤدى، ماشي غير قيمة التخفيض المكتوبة فالكوبون. إلا ما كانش المنتوج المضاف مطلوب أصلا، كيحذّر المستخدم من هاد الخيار.

حساب الكلفة الخفية ديال الكوبونات

«الكلفة الخفية ديال الكوبون» هي قيمة العرض اللي قرب يسالي وما تستعملش بعد. حيث إن MCP يقدر يرجّع غير اسم الكوبون، فالمشروع كيرجع للمنيو الحالي باش يقدّر قيمتو:

• كوبون التخفيض بعد حد أدنى: «نقص 12 من بعد 50» كيتحسب مباشرة بـ 12 يوان.
• كوبون اشترِ واحدا وخذ الثاني مجانا: «بطاطا متوسطة، الثانية مجانا» كيتحسب حسب ثمن المنتوج فالمينيو.
• كوبون بثمن ثابت: «قهوة أمريكانو مثلجة متوسطة بـ 9.9 يوان» كيتحسب بطرح 9.9 يوان من الثمن الأصلي فالمينيو.

إلا ما لقا المشروعش المنتوج المطابق فالمنيو، كيسجل قيمة الكوبون بـ 0 وكيبيّن هاد الشي فالتقرير. ما كيحطش تقدير باين معقول ولكن ما عندوش أساس.

تحليل عادات الاستهلاك على المدى الطويل

وحدة التدقيق تقدر تجمع من الطلبات السابقة عدد الطلبات، المصاريف الإجمالية، متوسط قيمة الطلب والمنتجات اللي كتطلب بزاف، وكتعطي اقتراحات مبنية على الهيكلة. مثلا، إلا كان المستخدم كيطلب نفس الهامبرغر بوحدو مرات كثيرة، يقدر النظام يقترح يقارن مع الوجبة المناسبة، حيث التحويل لوجبة يقدر غالبا ينقص المصاريف. الطلبات اللي ترجع كاملة كيتحيدو من الحساب باش ما يتحسبوش ضمن الاستهلاك.

التحضير

قبل ما تستعمل وظائف MCP على الإنترنت، خاصك توجد هاد البيئة:

• عميل كيدعم الموصلات المخصصة ديال MCP، بحال WorkBuddy اللي كيتشرح فـ README.
• Token مأخوذ من منصة MCP المفتوحة ديال ماكدونالدز.
• إلا بغيتي تشغّل الاختبارات محليا، خاصك Python 3.8 ولا إصدار أحدث.

الاختبارات المحلية الأربعة ما محتاجاش لـ MCP Token؛ ولكن البحث فالمينيو الحقيقي، كوبونات الحساب والطلبات السابقة كيحتاج Token صالح.

طلب وتجهيز MCP Token

الخطوة الأولى: طلب Token

دخل لـ منصة MCP المفتوحة ديال ماكدونالدز، دخل برقم الهاتف، ومن بعد فعّل MCP Token فلوحة التحكم ونسخو.

الخطوة الثانية: إنشاء إعدادات MCP

المستودع فيه ملف إعدادات منزوع البيانات الحساسة سميتو mcp-config.example.json. البنية ديال الإعدادات هي:

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

بدّل ${MCD_MCP_TOKEN} بالـ Token ديالك، ومن بعد دخلو فإعدادات MCP Client. ما ترفعش الـ Token الحقيقي لمستودع عمومي، وما تبينوش فالتصاور، السجلات ولا تقارير المشاكل.

الخطوة الثالثة: التفعيل فـ WorkBuddy

1. حل WorkBuddy، ومن الجهة اليسرى دخل لـ «الخبراء، المهارات والموصلات»، واختار تبويب «الموصلات».
2. كليكي على «موصل مخصص»، ومن بعد اختار «إعداد MCP».
3. لسّق إعدادات JSON اللي بدّلتي فيها الـ Token، ومن بعد حفظ.
4. رجع للائحة الموصلات المخصصة، وفعّل mcd-mcp.

طريقة الاستعمال الأساسية

المثال الأول: لقا تركيبة حسب الميزانية

اختار المطعم الأول، ومن بعد وضّح الميزانية، نوع الماكلة اللي بغيتي وعدد الاختيارات اللي بغيتي تقارن. تقدر تبعث مباشرة:

بغيت نطلب التوصيل من ماكدونالدز، من بعد ما نختار المطعم حسب ليا:
عندي كوبونات، وبغيت هامبرغر + بطاطا + مشروب، والميزانية ديالي 40 يوان،
شنو نطلب باش نخلّص أقل؟ عطيني جوج اقتراحات وقارن بينهم.

المساعد غادي يقرا منيو المطعم الحالي والكوبونات المتاحة، ويولّد تركيبات ممكنة، ومن بعد يحسب الثمن الحقيقي باستعمال MCP. نتيجة نموذجية تقدر توصي بوجبة من ثلاثة منتجات بـ 33.5 يوان، وتقارنها مع هامبرغر وبطاطا مفردين بـ 37 يوان.

المثال الثاني: تحديد الطبق الرئيسي والمرافق

الميزانية 35 يوان، وبغيت طبق رئيسي بالدجاج ومرافق واحد.
قلب على المنتجات المتاحة حاليا فالمطعم، وعطيني اقتراحا، بديلا، وخيارا ما كتوصيش به،
وشرح علاش كل خيار أرخص ولا أغلى.

هاد النوع ديال الطلبات كيخلي المساعد ياخذ بعين الاعتبار الميزانية، الحاجة للشبع ونوع المنتوج، وكيمنعو يوصي غير بأرخص اختيار مطلقا بلا ما يلبي الحاجة.

المثال الثالث: واش الزيادة باش تستعمل الكوبون كتستاهل؟

عندي كوبون «نقص 12 من بعد ما توصل لـ 50».
قارن ليا حسب الحاجة الحالية: الشراء المباشر، الزيادة لاستعمال الكوبون، وشراء وجبة،
وحسب المبلغ النهائي المؤدى. إلا كانت الزيادة أغلى، نبّهني بوضوح.

فالمقارنة، خاص التركيز يكون على المبلغ النهائي المؤدى، ماشي قيمة التخفيض المكتوبة فالكوبون. المشروع كيدخل كلفة المنتجات الجديدة فالحساب، وكيبيّن واش الوجبة مربوحة أكثر من الزيادة.

المثال الرابع: تدقيق فالاستهلاك الأخير

حلل ليا طلبات ماكدونالدز ديالي فالأشهر الأخيرة:
حسب عدد الطلبات، المصاريف الإجمالية ومتوسط قيمة الطلب، وخرج المنتجات اللي كنطلب بزاف؛
وزيد عليها الكوبونات اللي قربات تسالي، القيمة المتوقعة وعدد الأيام الباقية،
وفالأخير قول ليا شنو خاصني نعالج الأول هاد الشهر.

هاد الشي كيفعّل مسار التدقيق الطويل. التركيز فالنتيجة كيكون على القيمة الإجمالية للكوبونات القريبة تسالي، عادات الاستهلاك والاقتراحات الهيكلية اللي تقدر تطبقها، ماشي غير أقل ثمن ديال طلب واحد.

تشغيل الاختبارات المحلية

من بعد ما تجيب مصدر المشروع، شغّل الاختبارات التالية فالجذر ديال المستودع باستعمال Python 3.8 ولا إصدار أحدث:

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

• test_saver.py: كيتحقق من تعداد التركيبات، الترتيب واكتشاف فخاخ الزيادة.
• test_auditor.py: كيتحقق من الكلفة الخفية، عادات الاستهلاك والحدود المرتبطة بالتاريخ.
• test_adapter.py: كيتحقق من تحويل الوحدات وتحليل استجابة MCP.
• test_order_adapter.py: كيتحقق من تحليل الطلبات والكوبونات، تصفية المبالغ المرجعة وتقدير قيمة الكوبون.

هاد الاختبارات الأربعة كتخدم محليا فقط وما محتاجاش لإعداد MCP Token. الـ README ما فيهش أوامر إضافية لتثبيت الحزم، وداكشي علاش خاص الاعتماد على الكود الفعلي ووثائق الدمج اللي فالمستودع.

فهم بنية المشروع

المشروع كيفصل بين استجابات MCP الخام وخوارزميات الأعمال باستعمال طبقة التكييف. الوحدات الرئيسية هي:

• src/saver.py: مسؤول على مسار التوفير فطلب واحد، وكيعدّد التركيبات الممكنة ويقارن المبالغ الحقيقية المؤداة.
• src/auditor.py: مسؤول على التدقيق الطويل، وحساب الكلفة الخفية ديال الكوبونات وإنشاء بروفايل الاستهلاك.
• src/mcd_adapter.py: مسؤول على مطابقة الحقول، تصفية المبالغ المرجعة، البحث العكسي على قيمة الكوبون، والتحويل الوحيد من «فلس» لـ «يوان».
• MCP_INTEGRATION.md: كيسجل MCP Server، الأدوات، مسار الاستدعاء وعقد الاستدعاء اللي تجرب فعليا.
• SKILL.md: كيشرح تعريف Skill ومسار العمل الكامل.

طبقة الخوارزميات ما كتتعاملش مباشرة مع استجابة MCP الخام، وهاد الشي كيعاون يتفادى اختلاف الحقول والخلط فـ وحدات المبالغ. خاص الانتباه خصوصا لأن بعض الواجهات تقدر تكون فيها جهة التحويل بين «فلس» و«يوان» مختلفة، وخص المعالجة تكون دائما عبر طبقة التكييف.

نصائح متقدمة للاستعمال

وضح أولا «شنو بغيتي تاكل»، ومن بعد قارن الأثمنة

أرخص ثمن ماشي بالضرورة هو الاختيار المناسب. فطلبك، كتب الطبق الرئيسي، المرافق، المشروب، عدد الأشخاص، الميزانية والحد الأدنى اللي محتاج، وخلي النظام يقارن بين اختيارات كتلبّي نفس الحاجة.

طلب شرح مصدر التوفير

تقدر تطلب من النتيجة توضّح «شنو هو الكوبون اللي تستعمل، لشنو تبدلات الوجبة، شنو تزاد فالطلب باش يكمل الشرط، وشحال توفر مقارنة بالاختيار الأساسي». هكذا ما غاديش تاخذ غير النتيجة، بل تقدر حتى تتأكد واش الاقتراح مناسب للحاجة الحقيقية ديالك.

فرّق بين قيمة الكوبون والربح الفعلي

كوبون قيمتو النظرية 12 يوان ما كيعنيش بالضرورة أنك غادي توفّر 12 يوان فطلبك الحالي. الحد الأدنى، المطاعم المعنية، المنتجات المتاحة وكلفة الزيادة كلهم كيبدلو الربح الحقيقي. خاصك تشوف قيمة الكوبون والمبلغ النهائي المؤدى بجوج.

عالج أولا الكوبونات القريبة تسالي واللي قيمتها واضحة

فالتدقيق الطويل، تقدر ترتب الكوبونات حسب عدد الأيام الباقية والقيمة اللي يمكن تأكيدها. الكوبونات اللي ما قدرش المشروع يرجع يلقى ثمنها الأصلي فالمنيو خاصها تبقى معلّمة كمجهولة أو بـ 0، وما خاصش التخمين فالمبلغ غير باش يخرج التقرير كامل.

استعمل بيانات المطعم الحالي كل مرة

ما تعاودش تستعمل أثمنة مطعم آخر ولا أثمنة من طلبات قديمة. المنيو، حالة التوفر ونطاق استعمال الكوبونات يقدرو يتبدلو، وخص كل قرار يعتمد على النتيجة الرسمية والآنية ديال المطعم الحالي.

حافظ على بيانات الحساب

الأفضل ديما تخزن الـ Token فمتغيرات البيئة ولا فإعدادات آمنة ديال العميل. ملي كتشارك الإعدادات علنا، خليه غير على شكل عنصر نائب بحال ${MCD_MCP_TOKEN}.

حدود التصميم والتنبيهات

• جميع الأثمنة خاصها تعتمد على النتيجة الفعلية ديال calculate-price فـ MCP.
• قيمة الكوبون اللي ما يمكنش تأكيدها من المنيو كتتحسب بـ 0 وكتتعلّم، بلا تخمين.
• طلبات الاسترجاع ما كتدخلش فمصاريف الاستهلاك.
• المشروع ما كيشجعش على شراء إضافات ما محتاجهاش المستخدم غير باش يستعمل كوبونا.
• الأطباق، الأثمنة، حالة التوفر ونطاق استعمال الكوبونات كتتحدد حسب النتائج الآنية ديال القنوات الرسمية ديال ماكدونالدز.
• هاد المشروع عمل مستقل مطوّر فإطار مسابقة، وماشي منتوج رسمي ديال ماكدونالدز.
• النتائج غير مرجع لاتخاذ قرارات الاستهلاك، وما كتعتبرش نصيحة طبية ولا غذائية ولا مهنية من أي نوع.

الخلاصة

مساعد التوفير فـ ماكدو كيجمع بين تحسين الطلب الآني والتدقيق فالاستهلاك الطويل: على المدى القصير كيستعمل الحساب الحقيقي باش يختار تركيبة الوجبة، المنتجات المفردة والكوبونات؛ وعلى المدى الطويل كيستعمل الطلبات ومخزون الكوبونات باش يكتاشف الخسائر الخفية بحال ارتفاع متوسط قيمة الطلب، تكرار طلب المنتجات المفردة وانتهاء صلاحية الكوبونات.

من بعد ما تجهّز MCP Token، تقدر تبدا بطلب فيه الميزانية والحاجة الغذائية، ومن بعد تجرب تدريجيا مقارنة الزيادة والتدقيق الشهري فالاستهلاك. وبالنسبة للمطورين، التقسيم بين saver.py وauditor.py وmcd_adapter.py كيقدم حتى هو مرجعا واضحا لتنظيم مساري MCP بجوج.