xiaozhangup/Oh-My-McDonald

选用指南

AI 根据 README 整理 · 2026/10/25 01:26:13

使用方式

通过命令行使用本地Python脚本，支持查询门店、餐品详情和购物篮报价等。

查看 README 依据

1. 用户用自然语言提出需求。 2. AI 根据需求选择对应的 MCP 查询工具。 3. AI 将查询结果与用户的预算、排除条件等进行匹配。 4. 按需调用本地 Python 脚本完成辅助处理。 5. 需要生成图片时，由本地渲染器输出 PNG。 6. 涉及食用或探店记录时，等待用户确认后再保存。 客户端需要具备相应的 MCP 接入和本地命令执行能力。 本项目不要求使用特定的 AI 模型，也不依赖 OpenAI API。 ## 命令行示例 以下命令均在项目根目录执行。 ### 查询武汉的门店 查询名称或位置中与“东澜岸”相关的门店： ```bash python oh-my-mcdonald/scripts/oh_my_mcdonald.py stores \ --city 武汉 \ --keyword 东澜岸 ``` ### 查询指定餐品详情 ```bash python oh-my-mcdonald/scripts/oh_my_mcdonald.py detail \ --store 1960151 \ --code 9900005456 ``` 其中： - `--store` 指定门店 ID。 - `--code` 指定餐品代码。 示例 ID 用于演示参数格式，实际查询时应使用 MCP 返回的有效数据。 ### 查询购物篮报价

部署要求

需要Python 3.11或更高版本、虚拟环境、支持中文的字体，使用实时查询时需麦当劳官方MCP访问凭据。

查看 README 依据

目前包含 **43 个粗体素模型**，使用 Python 构建整数几何，按 **8 px/格** 的规则进行渲染。 四种主要场景分别是： | 场景 | 展示内容 | | --- | --- | | 餐品图鉴 | 分区展馆、转弯步道、餐品展台和点亮状态 | | 优惠日历 | 整月优惠街区、今日信息、到期提醒和活动告示栏 | | 门店比价 | 体素街道、门店建筑和对应的价格标牌 | | 营养餐桌 | 套餐餐盘、营养小票和餐外搭配参考 | 渲染由本地 Python 脚本完成，不需要调用 OpenAI API 或其他图片生成 API。 街道、展馆和餐桌是数据可视化场景，门店的排列用于比较报价。 ## 安装与运行 ### 环境要求 - Python 3.11 或更高版本 - 能够正常使用的 Python 虚拟环境 - 支持中文的字体，推荐 Noto Sans CJK - 使用实时查询功能时，需要麦当劳官方 MCP 的访问凭据 项目的主要 Python 依赖包括： | 依赖 | 版本要求 | | --- | --- | | Pillow | `>=10,<13` | | NumPy | `>=1.24,<3` | 依赖统一记录在 `requirements.txt` 中。 ### 1. 克隆仓库 ```bash

已知限制

项目不支持自动下单、付款或领取优惠券，也不提供云端同步和后台轮询。价格比较仅限选定门店、同一商品和规格，最多3家门店。

查看 README 依据

其中包括真实数据查询的验证情况以及相关限制。 预览图片所使用的真实 MCP 快照日期为 **2026 年 10 月 24 日**，后续查询结果可能发生变化。 ## 实现边界 当前实现范围如下： **价格比较** 只比较选定门店、同一商品和同一规格在当前测试方案下的报价。最多比较 3 家门店，不推断其他门店的价格。 **优惠信息** 按本人券包的有效日期统计券数，并展示已发布活动。适用时段、门店与商品条件另行处理。 **营养计算** 仅计算精确匹配的餐品。缺失字段单独说明，不使用其他商品的营养数据代替。额外展示的蔬菜、水果和奶类不计入本餐。 **食用记录** 订单查询结果先作为待确认信息。用户确认实际吃过后，才保存食用记录并点亮图鉴。探店记录同样需要用户确认。 **自动化范围** 项目不支持自动下单、付款或领取优惠券，也不提供云端同步和后台轮询。 **图片与地图** 体素场景由本地程序生成，仅用于信息展示。门店比价街道是示意场景，不包含真实道路或地理位置关系。 ## 项目结构 主要文件和目录如下： ```text Oh-My-McDonald/ ├── oh-my-mcdonald/ │ ├── SKILL.md │ ├── scripts/ │ │ └── oh_my_mcdonald.py