몇 분에서 몇 시간까지 이어지는 작업에서 하위 에이전트, 메모리, 샌드박스를 조율해 조사하고 코드를 작성하며 결과물을 만드는 오픈소스 장기 작업용 슈퍼 에이전트 하네스입니다.
Ayzzz123/mcd-coupon-strategist
매장별 최저가 주문 방법을 계산하고 만료 임박 쿠폰을 알려주는 맥도날드 중국 MCP 기반 Skill입니다.
- 스타
- 576
- 포크
- 20
- 열린 이슈
- 0
- 마지막 커밋
- 6일 전
어떤 프로젝트인가요?
mcd-coupon-strategist는 McDonald's China MCP 서버를 기반으로 만든 Python 주문 비용 도우미입니다. 한 번의 주문에 대해 현재 매장의 메뉴와 해당 매장에서 사용할 수 있는 쿠폰을 가져오고, 단품·세트·쿠폰 조합·추가 메뉴의 조합을 모두 살펴본 뒤 MCP calculate-price 도구로 각 후보의 가격을 계산합니다. 그런 다음 가장 저렴한 선택지를 추천하고, 쿠폰 사용 기준을 맞추려고 메뉴를 추가했을 때 오히려 비용이 더 들면 알려줍니다.
장기적인 지출을 파악할 때는 과거 주문 내역과 계정의 쿠폰 목록을 읽어 만료 임박 쿠폰의 가치, 주문당 평균 지출, 시간대별 지출 패턴을 보여줍니다. 포인트 잔액과 만료일도 확인하고, 캠페인 날짜와 쿠폰 유효 기간을 함께 표시합니다. 쿠폰 코드를 사용할 수 있으면 calculate-price로 쿠폰 가치를 계산하고, 그렇지 않으면 메뉴 가격을 바탕으로 추정합니다. 가치를 알 수 없는 쿠폰은 임의로 추측하지 않고 미상으로 표시합니다.
데모는 fixtures 폴더에 기록된 MCP 응답을 사용해 오프라인으로 실행되며 Python 표준 라이브러리만 사용하므로 토큰 없이 체험할 수 있습니다. 실제 서버에 연결해 실행하려면 McDonald's MCP 토큰이 필요합니다.
핵심 기능
- 01현재 매장의 단품·세트·쿠폰 기반 주문을 비교합니다.
- 02가격을 추정하지 않고 MCP calculate-price 도구로 각 후보의 가격을 계산합니다.
- 03쿠폰 중복 적용이나 메뉴 추가로 최종 비용이 더 커지는 경우를 알려줍니다.
- 04과거 및 현재 쿠폰 데이터를 바탕으로 만료 임박 쿠폰과 액면가를 보여줍니다.
- 05주문 내역을 주문당 평균 지출과 시간대별로 요약합니다.
- 06기록된 응답을 사용해 데모 모드에서 완전히 오프라인으로 실행됩니다.
활용 사례
- 맥도날드 매장에서 정해진 예산으로 가장 저렴한 메뉴 조합을 고를 때.
- 쿠폰을 사용하거나 기준 금액을 맞추기 위해 메뉴를 추가할 가치가 있는지 확인할 때.
- 맥도날드 계정에서 만료가 임박한 쿠폰과 포인트를 관리할 때.
- 계층형 어댑터 설계를 활용한 MCP 기반 주문 워크플로 구축 방법을 익힐 때.
빠른 시작
- 1
저장소를 클론합니다
git clone https://github.com/Ayzzz123/mcd-coupon-strategist.git - 2
프로젝트 디렉터리로 이동합니다
cd mcd-coupon-strategist - 3
설정 없이 데모를 실행합니다(MCP Token 불필요)
python demo.py
사용 전 알아둘 점
- 실제로 사용하려면 open.mcd.cn에서 발급받은 맥도날드 중국 MCP Token이 필요합니다.
- 바코드가 없거나 메뉴와 일치하지 않는 쿠폰의 절약 금액은 알 수 없음으로 표시될 수 있습니다.
토픽
자주 묻는 질문
- mcd-coupon-strategist은(는) 무엇인가요?
- 매장별 최저가 주문 방법을 계산하고 만료 임박 쿠폰을 알려주는 맥도날드 중국 MCP 기반 Skill입니다. mcd-coupon-strategist는 McDonald's China MCP 서버를 기반으로 만든 Python 주문 비용 도우미입니다. 한 번의 주문에 대해 현재 매장의 메뉴와 해당 매장에서 사용할 수 있는 쿠폰을 가져오고, 단품·세트·쿠폰 조합·추가 메뉴의 조합을 모두 살펴본 뒤 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 통계는 매일 갱신됩니다.
관련 프로젝트
브라우저 WebUI, 터미널 클라이언트, 채팅 앱 채널, 도구, 메모리 및 MCP를 지원하는 Python 기반 셀프 호스팅 개인 AI 에이전트 프레임워크입니다.
LangGraph에서 복잡한 다단계 작업을 바로 실행할 수 있는, 필요한 기능을 모두 갖춘 Python용 에이전트 하네스입니다.
질문을 계획하고 웹·로컬 자료를 수집해 인용이 포함된 보고서를 작성하는 오픈소스 자율 연구 에이전트
LLM 에이전트의 대화와 실행을 Python 및 TypeScript 앱에서 활용할 수 있는 영구적이고 구조화된 메모리로 바꾸는 에이전트 네이티브 메모리 인프라입니다.