zengshuangzi/mcd-money-saver

概要

麦麦省钱助手 (McD Money Saver) は、マクドナルドでの支出を抑えるスマートアシスタントです。マクドナルド公式MCPサービス（アプリがマクドナルドのシステムと通信するための方法）に接続し、クーポンを自動収集し、ポイントを確認し、価格を比較し、最安の注文方法を教えてくれます。すべて1か所で完結します。

これは、マクドナルドのプログラマーズデイ創造開発コンテストへのエントリーとして、テンセントのWorkBuddyツールの支援を受けて構築されました。

解決する問題

READMEには、対処する4つの一般的な不満がリストされています：

複数のクーポンがあるが、どれが最適か、組み合わせられるかわからない。
利用可能な「麦麦省」クーポンをすべて取得したかどうか不明。
予算が限られている（例：30元）が、お腹いっぱいになり、超えない食事が必要。
カロリーを気にしつつ、最良の取引を逃したくない。

主な機能

機能	説明
スマートクーポン取得	利用可能な麦麦省クーポンをワンクリックで取得（`auto-bind-coupons`というツールを使用）。
最適なセット検索	クーポンを使用して、最も節約できる食事/食品の組み合わせを計算。
予算注文	固定予算内で最安の注文方法を見つける。
カロリー対応の取引	カロリーを目標以下に保ちながら、最良の価格を見つける。
ポイント照会	ポイント残高を確認し、ポイント交換を考慮してさらに節約。

仕組み

アシスタントは、複数のマクドナルドMCPツールを順に連鎖させます：

近くのマクドナルド店舗を検索
クーポンと取得可能なものを確認
利用可能なクーポンを取得
メニューを確認
calculates-priceツールを使用して価格を比較
最適なプランを出力

つまり、本質的に多段階パイプラインです：位置特定 → 確認 → 取得 → 比較 → 推奨。

インストールと使用方法

前提条件：

マクドナルドMCPトークン（open.mcd.cn/mcpでログインしてアクティベートすると無料で取得できます）。
Streamable HTTPをサポートするMCPクライアント（READMEはテンセントWorkBuddyを推奨）。

セットアップ：

マクドナルドMCPサーバー設定（URL https://mcp.mcd.cn、トークンをBearerヘッダーとして使用）をクライアントに追加します。
このリポジトリのSKILL.mdファイルをクライアントに読み込みます。WorkBuddyではスキルディレクトリにドロップします。他のクライアントではエージェントプロンプトとして読み込みます。

READMEの例のやり取り：

「30元しかないけど、マクドナルドが食べたい。」 → アシスタントは「30マイナス5」クーポンがある近くの店舗を見つけ、割引後ちょうど30元になる食事を推奨し、節約額を伝えます。
「取得できるクーポンは？」 → 3枚のクーポンを取得し、どれが最も価値があるかを伝えます。
「500カロリー未満に抑えて、節約できるところは節約して。」 → 480カロリーで割引のあるセットを提案し、6元節約できます。

対象ユーザー

予算が限られている学生や社会人で、使いすぎずにしっかり食べたい人。
注文前に必ずクーポンをチェックするお得好きな人。
カロリーを気にしつつ割引も欲しい人。

重要な注意点

これはコンテストのエントリーであり、マクドナルドの公式製品ではありません。
すべての価格、クーポン、在庫はマクドナルド公式チャネルからリアルタイムで取得されます。アシスタントが捏造することはありません。
栄養情報は参考用であり、医学的または食事上のアドバイスではありません。
使用はコンテストおよび学習目的に限定され、マクドナルドの利用規約とMCPサービス規則に従う必要があります。

プロジェクト内容

SKILL.md — コアスキル定義（節約ロジックをプロンプトとして）
README.md — この紹介
CONTEST_DECLARATION.md — 公式コンテスト宣言（変更不可）
MCP_INTEGRATION.md — MCP設定とツール呼び出しの詳細
mcp-config.example.json — サンプル（マスクされた）設定
workbuddy.md — WorkBuddyセッションの開発コンテキスト

注：READMEは中国語で書かれています。この説明はその内容の忠実な翻訳であり、機能や主張を追加したものではありません。