mcdonalds-coupons

McDonald's クーポンアシスタント

McDonald's China MCP Server に接続し、ユーザーがキャンペーンを見つけたり、クーポンを取得したり、クーポンウォレットを管理したりできるスキルです。

概要

このスキルは、McDonald's の公式 MCP（Model Context Protocol）サービスを使用して、以下を行います。

• 利用可能なクーポンを検索（麦麦省）
• すべてのクーポンをワンクリックで取得
• キャンペーンカレンダーを確認
• ユーザーのクーポンウォレットを表示

トークン管理

トークンがあるか確認する

最初に、ユーザーがトークンを設定しているか確認します。

python scripts/token-manager.py list

トークンがない場合は、取得方法を案内する

📝 首次使用需要 MCP Token

获取步骤:
1. 访问 https://open.mcd.cn/mcp
2. 点击右上角「登录」
3. 使用手机号验证登录
4. 点击「控制台」→「激活」
5. 复制生成的 Token

添加 Token:
python scripts/token-manager.py add <名称> <token>

示例:
python scripts/token-manager.py add personal 1kxNLFYT...

複数のトークンを管理する

ユーザーはカスタムニックネームを付けて複数のトークンを管理できます。

# Add tokens - nickname can be anything user wants
python scripts/token-manager.py add 我自己 <token1>
python scripts/token-manager.py add 老妈 <token2>
python scripts/token-manager.py add 女朋友 <token3>

# List all tokens
python scripts/token-manager.py list
# Output:
# 🎫 已保存的 Token:
# ----------------------------------------
#   我自己: 1kxNLFYT...LuqJ ← 当前
#   老妈: 2abCDEFG...XyZ
#   女朋友: 3mnOPQRS...123
# ----------------------------------------

# Switch active token
python scripts/token-manager.py switch 老妈

# Remove a token
python scripts/token-manager.py remove 女朋友

保存先： ~/.mcd-tokens.json（自動作成、権限 600）

トークンは永続的にキャッシュされます。ユーザーは一度追加するだけで、いつでも利用できます。

クイックリファレンス

操作	MCP ツール	説明
利用可能なクーポンを一覧表示	available-coupons	取得可能な麦麦省クーポンを表示
すべてのクーポンを取得	auto-bind-coupons	すべてをワンクリックで取得
自分のクーポンを表示	my-coupons	ユーザーが取得したクーポンウォレット
キャンペーンを確認	campaign-calender	現在および今後のキャンペーン
現在時刻を取得	now-time-info	有効性を確認するためのサーバー時刻

実装

ヘルパースクリプトを使用する（推奨）

# Uses token from token manager automatically
python scripts/mcd-mcp.py available-coupons

# Or specify token directly
python scripts/mcd-mcp.py available-coupons <token>

HTTP を直接呼び出す

curl -X POST https://mcp.mcd.cn/mcp-servers/mcd-mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"available-coupons"}}'

レスポンスを解析する

{
  "result": {
    "content": [{"type": "text", "text": "...coupon data..."}]
  }
}

テキストを抽出します：result.content[0].text

ワークフローの例

ユーザー：「有什么麦当劳优惠？」

1. トークンがあるか確認 → なければ、追加方法を案内
2. available-coupons を呼び出す
3. 価格とともにクーポンを提示
4. すべて取得するか尋ねる

ユーザー：「帮我领券」／「一键领取」

1. auto-bind-coupons を呼び出す
2. 取得に成功した枚数を報告
3. 有効期限を伝える

ユーザー：「切换到我妈的账号领券」

1. python scripts/token-manager.py switch 老妈 を実行
2. 次に auto-bind-coupons を呼び出す
3. 「「老妈」のアカウントでクーポンを X 枚取得しました」と確認する

ユーザー：「帮我把女朋友的麦当劳加进来」

1. https://open.mcd.cn/mcp からトークンを取得する方法を案内
2. ユーザーにニックネームを尋ねる：「このアカウントにどんな名前を付けますか？」
3. python scripts/token-manager.py add <ユーザーが付けた名前> <token> を実行
4. 追加を確認する

応答スタイル

クーポン情報を提示する際は、次のようにします。

• 食べ物の絵文字を使う（🍔🍟🍗）
• 価格と割引額を目立たせる
• カテゴリーごとにまとめる
• 有効期限を記載する
• （複数ある場合）現在アクティブなアカウントを示す

よくある問題

問題	解決策
401 Unauthorized	トークンが無効または期限切れです。新しいトークンを取得してください
429 Too Many Requests	レート制限（600/分）です。待ってから再試行してください
トークンが設定されていない	token-manager.py add の実行方法を案内してください
アカウントが違う	token-manager.py switch を使用してください

レート制限

• トークンごとに毎分 600 リクエスト
• 各トークンは独立しています（複数のアカウントを並行して利用できます）