zengshuangzi/mcd-money-saver

그것이 무엇인가

麦麦省钱助手 (McD Money Saver) 는 맥도날드에서 지출을 줄이는 데 도움을 주는 스마트 어시스턴트입니다. 맥도날드 공식 MCP 서비스(앱이 맥도날드 시스템과 통신하는 방법)에 연결하여 쿠폰을 자동으로 수집하고, 포인트를 확인하고, 가격을 비교하고, 가장 저렴한 주문 방법을 알려줍니다. 모든 것이 한 곳에서 이루어집니다.

이것은 맥도날드 프로그래머의 날 창의 개발 경연 대회 출품작으로, 텐센트의 WorkBuddy 도구의 도움을 받아 구축되었습니다.

해결하는 문제

README에는 해결하는 네 가지 일반적인 불만 사항이 나열되어 있습니다:

쿠폰이 여러 장 있지만 어떤 것이 가장 좋은지, 결합할 수 있는지 모릅니다.
사용 가능한 "麦麦省" 쿠폰을 모두 받았는지 확실하지 않습니다.
예산이 빠듯한 경우(예: 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는 중국어로 작성되었습니다. 이 설명은 내용의 충실한 번역이며 기능이나 주장을 추가하지 않았습니다.