spideymooon/McOracle

해결하는 문제

사람들은 종종 인생 질문에 재미있고 참신한 답을 원하지만, AI 챗봇은 사실을 지어내는 경향이 있습니다. 그리고 음식 추천을 요청하면 메뉴 항목이나 가격을 발명할 수도 있습니다. McOracle은 장난스러운 부분(무작위 오라클)과 사실적 부분(실제 맥도날드 중국 데이터)을 분리하여 이 문제를 해결합니다. 무작위로 선택된 중국식 오라클 격언을 제공한 다음, 공식 맥도날드 중국 MCP(모델 컨텍스트 프로토콜)를 사용하여 실제 인근 매장, 실제 판매 가능한 메뉴 항목, 검증된 가격을 조회합니다. 제품, 가격, 매장을 절대 날조하지 않습니다. 또한 명시적으로 확인할 때까지 주문을 거부하며, 확인 후에도 주문만 생성할 뿐 자동 결제는 하지 않습니다.

작동 방식

McOracle은 "스킬"(WorkBuddy 어시스턴트를 위한 패키지된 기능)로 구성됩니다. 흐름은 다음과 같습니다:

1. 질문하기 — "오늘 그만둬야 할까?"와 같은 질문을 합니다.
2. 오라클 뽑기 — Python 스크립트(draw-oracle.py)가 secrets 모듈을 사용하여 로컬 라이브러리(oracle-library.json)에서 104개의 독창적인 중국어 오라클 격언 중 하나를 선택합니다. 뽑기는 상태 파일에 고정되어 해석, 추천, 카드에 동일한 격언이 재사용되며, 명시적으로 다시 뽑기를 요청할 때까지 유지됩니다.
3. 실제 추천 받기 — 원한다면 시스템은 맥도날드 중국 공식 MCP 도구(query-nearby-stores, query-meals, calculate-price)를 호출하여 인근 매장을 찾고 실제 가격이 확인된 "오늘의 필수 주문" 항목을 표시합니다. 가격은 센트 단위로 표시되며 항상 검증됨으로 표시되거나 확인되지 않은 경우 "가격 미검증"으로 표시됩니다.
4. 운세 카드 생성 — Python 스크립트(generate-card.py)가 고정 1200×1600 PNG를 렌더링하며, 진한 빨간색과 금색 타로 스타일 템플릿을 사용합니다. 음식 이미지는 가능한 경우 공식 제품 이미지 URL에서 가져옵니다. 사용할 수 없으면 대체 개념 일러스트(명확히 표시) 또는 오류 코드가 있는 저하된 카드가 사용됩니다. 성공을 절대 위장하지 않습니다.
5. 선택적 주문 — "주문 확인"이라고 말한 후에만 시스템이 가격을 다시 확인하고 create-order MCP 도구를 호출하여 공식 결제 링크가 있는 실제 주문 번호를 반환합니다. 주문 생성은 결제가 아닙니다. 시스템은 자동 결제를 하지 않습니다.

오라클만 원하면 흐름은 2단계에서 중지됩니다. 위치를 공유하거나 MCP 도구를 호출하도록 강요받지 않습니다.

대상 사용자

이 프로젝트는 다음을 위해 설계되었습니다:

• 캐주얼한 질문에 재미있고 빠른 "운세" 답을 원하고, 공유할 수 있는 시각적으로 매력적인 카드를 원하는 사람.
• 실제 상업 API(맥도날드 중국 MCP)를 안전하고 날조 없는 방식으로 통합하는 스킬을 시도해보고 싶은 WorkBuddy 데스크톱 어시스턴트 사용자.
• 실제 MCP 통합, 안전 제어, 테스트를 갖춘 스킬의 참조 구현이 필요한 맥도날드 중국 개발자 챌린지 참가 개발자.

이것은 예측 도구가 아니며 전문적인 조언을 대체하지 않습니다. 오라클은 오락용입니다.

하이라이트

• 진정한 무작위성 — 오라클 뽑기는 Python의 secrets 모듈을 사용하여 진정한 무작위 선택을 하며, 모델 즉흥이 아닙니다.
• 항상 검증된 가격 — 추천된 각 항목은 실제 MCP 쿼리에서 가져옵니다. 가격을 검증할 수 없으면 카드와 대화에 "가격 미검증"으로 표시하고 숫자를 발명하지 않습니다.
• 엄격한 주문 안전 — 사용자가 명시적으로 확인하기 전에는 주문이 생성되지 않으며, 항목, 매장, 가격의 변경은 이전 확인을 무효화합니다. 시스템은 자동 결제를 하지 않으며 성공을 위장하지 않습니다.
• 오프라인 가능 비주얼 — 운세 카드는 Pillow로 프로그래밍 방식으로 렌더링됩니다. 이미지 생성 API나 키가 필요 없습니다. 템플릿은 실패하지 않으며, 제품 이미지가 없으면 정직하게 저하됩니다(종료 코드 2, ok=false).
• 24/24 테스트 통과 — 세 가지 테스트 스위트가 오라클 무작위성/잠금, 카드 생성 및 저하, 주문 안전 상태 전환(모의 전용, 실제 주문 없음)을 다룹니다.
• 명확한 제한 사항 문서화 — 주문에서 결제까지의 전체 루프는 종단 간 검증되지 않았습니다. 배달 및 쿠폰 흐름은 README에서 미검증으로 표시됩니다.