Repolode
Ayzzz123

Ayzzz123/mcd-coupon-strategist

店舗で最も安く注文できる方法を計算し、期限間近のクーポンを知らせる、マクドナルド中国向けMCPベースのSkill。

スター
576
フォーク
20
未解決の Issue
0
最終コミット
6 日前

これは何?

mcd-coupon-strategistは、McDonald's China MCP serverを基盤とする、Python製の注文コスト計算アシスタントです。1回の注文について、現在の店舗のメニューとその店舗で使えるクーポンを取得し、単品、セット、クーポンの併用、追加商品を組み合わせた候補を列挙して、それぞれの価格をMCPのcalculate-priceツールで計算します。最も安い選択肢を提案し、クーポンの利用条件を満たすために商品を追加した結果、かえって高くなる場合は警告します。

長期的な支出を把握するため、過去の注文とアカウントのクーポン一覧を読み込み、期限が近いクーポンの価値、注文あたりの平均支出、時間帯別の支出傾向を報告します。ポイント残高と有効期限も確認し、キャンペーンの日程とクーポンの有効期間をあわせて一覧表示します。クーポンコードがある場合はcalculate-priceでクーポンの価値を計算し、ない場合はメニュー価格から推定します。価値が不明な場合は推測せず、不明として報告します。

デモはfixturesフォルダに記録されたMCPレスポンスを使ってオフラインで実行でき、Python標準ライブラリのみを使用するため、トークンなしで試せます。ライブサーバーに接続して実行するには、McDonald's MCPトークンが必要です。

主な機能

  • 01現在の店舗で、単品・セット・クーポンを使った注文を比較します。
  • 02候補ごとの価格を推定ではなく、MCPのcalculate-priceツールで計算します。
  • 03クーポンの併用や商品の追加によって、かえって高くなる場合に警告します。
  • 04過去および現在のクーポン情報をもとに、期限が近いクーポンとその額面を報告します。
  • 05注文履歴を平均支出と時間帯別に集計します。
  • 06記録済みのレスポンスを使い、デモモードで完全オフライン実行できます。

ユースケース

  • マクドナルドの店舗で、予算内で最も安くなる食事の組み合わせを選ぶ。
  • クーポンを使う、または利用条件を満たすために商品を追加する価値があるか確認する。
  • マクドナルドのアカウントで期限が近いクーポンやポイントを把握する。
  • レイヤー化されたアダプター設計を用いた、MCPベースの注文ワークフローの構築方法を学ぶ。

クイックスタート

  1. 1

    リポジトリをクローンする

    git clone https://github.com/Ayzzz123/mcd-coupon-strategist.git
  2. 2

    プロジェクトディレクトリに移動する

    cd mcd-coupon-strategist
  3. 3

    ゼロコンフィグのデモを実行する(MCP Tokenは不要)

    python demo.py

使う前に知っておきたいこと

  • 実際に利用するには、open.mcd.cnで取得したマクドナルド中国のMCP Tokenが必要です。
  • バーコードやメニューとの照合ができないクーポンの節約額は、不明と表示される場合があります。

トピック

よくある質問

mcd-coupon-strategist とは?
店舗で最も安く注文できる方法を計算し、期限間近のクーポンを知らせる、マクドナルド中国向けMCPベースのSkill。 mcd-coupon-strategistは、McDonald's China MCP serverを基盤とする、Python製の注文コスト計算アシスタントです。1回の注文について、現在の店舗のメニューとその店舗で使えるクーポンを取得し、単品、セット、クーポンの併用、追加商品を組み合わせた候補を列挙して、それぞれの価格をMCPのcalculate-priceツールで計算します。最も安い選択肢を提案し、クーポンの利用条件を満たすために商品を追加した結果、かえって高くなる場合は警告します。
mcd-coupon-strategist は無料で使えますか?ライセンスは?
mcd-coupon-strategist は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
mcd-coupon-strategist は今もメンテナンスされていますか?
活発にメンテナンス中。mcd-coupon-strategist の最終コミットは 2026年10月14日 です。
mcd-coupon-strategist は何に使えますか?
マクドナルドの店舗で、予算内で最も安くなる食事の組み合わせを選ぶ。 クーポンを使う、または利用条件を満たすために商品を追加する価値があるか確認する。 マクドナルドのアカウントで期限が近いクーポンやポイントを把握する。 レイヤー化されたアダプター設計を用いた、MCPベースの注文ワークフローの構築方法を学ぶ。
mcd-coupon-strategist のインストール方法は?
リポジトリをクローンする: git clone https://github.com/Ayzzz123/mcd-coupon-strategist.git プロジェクトディレクトリに移動する: cd mcd-coupon-strategist ゼロコンフィグのデモを実行する(MCP Tokenは不要): python demo.py
mcd-coupon-strategist はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/Ayzzz123/mcd-coupon-strategist

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト