Sam-Hui-dot/mcd-budget-meal

What it solves

This project helps users optimize their food spending at McDonald's by automating the process of comparing meal combinations against a set budget. It prevents the guesswork of manual selection by using official pricing data to generate, compare, and report on multiple meal options that fit your specific financial constraints.

How it works

The project functions as an AI-powered "Skill" for MCP (Model Context Protocol) clients. It uses an AI agent to understand your dietary preferences and budget, then interacts with McDonald's official MCP server to fetch real-time menu data and pricing. A local Python script processes these options to verify budget compliance, calculate price differences between combinations, and generate a clean, interactive HTML report for the user to review.

Who it’s for

It is designed for users who frequently order from McDonald's and want to maximize their value within a specific budget. It is particularly useful for those who already use AI client tools (like WorkBuddy or Cursor) and want to integrate automated, data-driven meal planning into their workflow.

Highlights

• Official Pricing Integration: Uses the official McDonald's MCP server to ensure all price quotes are accurate and based on real-time availability.
• Budget-First Logic: Automatically filters and suggests meal combinations that respect your input budget, clearly highlighting any overages.
• Interactive Reporting: Generates standalone HTML reports that allow users to adjust budgets, compare item compositions, and view price differences without needing to re-run queries.
• Privacy-Focused: The tool runs locally and does not store or transmit your personal authentication tokens or private data to the repository.