Oh-My-McDonald
https://github.com/user-attachments/assets/e0bc2d36-26e1-42b6-9329-985fb6f0117f
Oh-My-McDonald 是一个基于麦当劳官方 MCP 的对话驱动 AI Skill。
Power your agent
การติดตั้งจากผู้เผยแพร่ ไม่ใช่เอนด์พอยต์ของ PlugMCP
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
https://github.com/user-attachments/assets/e0bc2d36-26e1-42b6-9329-985fb6f0117f
Oh-My-McDonald 是一个基于麦当劳官方 MCP 的对话驱动 AI Skill。
基于麦当劳官方 MCP 的对话式 AI Skill,支持餐品推荐、门店比价、优惠查询、营养计算和探索记录,并通过 Python 生成体素风格分享图片。
你可以直接告诉 AI 今天想吃什么、预算多少、有什么不想吃的,也可以查询门店价格、优惠券、活动和餐品营养。吃过的餐品和去过的门店经过确认后,还能保存成自己的探索记录。
项目使用 Python 本地脚本处理数据和生成图片,将查询结果整理成四种体素风格的 PNG 场景。不需要网页界面,也不依赖图片生成 API。
餐品图鉴使用演示记录,图片中保留了演示标识。其余预览基于 2026 年 10 月 24 日的真实 MCP 查询快照,并非实时数据。发布图片仅展示必要的餐品名称、门店名称、价格、营养数据和优惠标题。
Oh-My-McDonald 提供一组可以由 AI 调用的本地工具。
项目通过麦当劳官方 MCP 获取餐品、门店、价格、优惠和营养信息,由 AI 理解用户的自然语言需求,再交给 Python 脚本完成查询辅助、数据处理、记录保存和图片渲染。
整个使用过程以对话为主。
例如,你可以问:
项目主要解决三个问题:
通过自然语言描述自己的需求,由 AI 查询真实餐品并筛选候选项。
支持:
候选餐品来自 MCP 查询结果,不由 AI 虚构。
查询指定门店的餐品价格,并比较同一商品、同一规格的到店价。
支持:
图片中,不同门店的门口会挂出对应价格,方便看出差异。
价格对应查询时选中的门店、商品规格和优惠方案。
通过 MCP 查询优惠券包和已发布的活动信息。
支持:
生成的优惠日历采用体素街区风格。
首页重点展示今日有效券、最近到期的优惠券和近期活动;完整明细放在续页中,避免所有信息挤在同一张图片里。
日历按本人券包的有效日期统计。券的适用时段、门店和商品条件按 MCP 返回的信息处理。
根据实际选择的餐品计算营养数据。
支持展示:
营养计算以准确匹配的餐品为基础,不使用名称相似但无法确认的商品替代。
如果存在缺失的营养字段,会单独列出,不将缺失值当作零。
生成的营养图片采用体素餐桌场景:
蔬菜、水果和奶类作为餐外搭配参考,单独展示;本餐数值只统计餐盘内的食物。
记录实际吃过的餐品和去过的门店。
餐品图鉴使用分区体素展馆呈现,包含转弯步道和餐品展台。
订单信息不会直接成为已完成的食用记录。
只有用户确认实际食用后,才保存记录并点亮对应餐品。
项目内置 Python 体素渲染实现,能够将查询结果生成为 PNG 图片。
目前包含 43 个粗体素模型,使用 Python 构建整数几何,按 8 px/格 的规则进行渲染。
四种主要场景分别是:
渲染由本地 Python 脚本完成,不需要调用 OpenAI API 或其他图片生成 API。
街道、展馆和餐桌是数据可视化场景,门店的排列用于比较报价。
项目的主要 Python 依赖包括:
依赖统一记录在 requirements.txt 中。
git clone https://github.com/xiaozhangup/Oh-My-McDonald.git
cd Oh-My-McDonald
python -m venv .venv
source .venv/bin/activate
以上激活命令适用于 Linux 和 macOS。
Windows 用户可以使用:
.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt
推荐安装 Noto Sans CJK。
如果需要使用指定字体,可以通过 OMM_FONT 环境变量提供本机字体路径:
export OMM_FONT="/path/to/your/font.ttf"
将路径替换为本机实际存在的中文字体文件。
python oh-my-mcdonald/scripts/oh_my_mcdonald.py --help
该入口提供项目本地辅助脚本的命令说明。
项目通过麦当劳官方 MCP 获取实际业务数据。
访问 麦当劳 MCP 控制台
按照官方页面的说明获取 MCP Token。
Token 通过本机环境变量或显式指定的 Codex 配置读取。
可以通过当前进程的环境变量提供 Token:
export MCD_MCP_TOKEN="YOUR_MCD_MCP_TOKEN"
也可以在执行命令时,通过 --codex-config 显式指定本机 Codex 配置文件:
python oh-my-mcdonald/scripts/oh_my_mcdonald.py \
--codex-config /本机/config.toml stores --city 武汉 --keyword 东澜岸
该方式读取本机配置中已有的 mcd-mcp 配置。
两种方式均用于本机凭据读取,不需要将实际 Token 放进项目文件。
项目的实际 MCP 集成涉及以下工具:
这些工具用于获取真实业务数据,本地 Python 脚本负责辅助处理和可视化。
完整接入说明和调用流程见:
项目提供 AI Skill 描述文件:
oh-my-mcdonald/SKILL.md
可以让支持 Skill 的 AI 客户端读取该文件,了解项目的能力、使用流程与限制。
具体的脚本命令和参数说明见:
一个典型的使用流程是:
客户端需要具备相应的 MCP 接入和本地命令执行能力。
本项目不要求使用特定的 AI 模型,也不依赖 OpenAI API。
以下命令均在项目根目录执行。
查询名称或位置中与“东澜岸”相关的门店:
python oh-my-mcdonald/scripts/oh_my_mcdonald.py stores \
--city 武汉 \
--keyword 东澜岸
python oh-my-mcdonald/scripts/oh_my_mcdonald.py detail \
--store 1960151 \
--code 9900005456
其中:
--store 指定门店 ID。--code 指定餐品代码。示例 ID 用于演示参数格式,实际查询时应使用 MCP 返回的有效数据。
python oh-my-mcdonald/scripts/oh_my_mcdonald.py quote \
--store 1960151 \
--basket examples/basket.json
购物篮内容由 JSON 文件提供,报价根据指定门店和当前测试方案计算。
不连接 MCP,也可以查看本地模型:
python oh-my-mcdonald/scripts/oh_my_mcdonald.py \
--out output models
输出目录为 output。
更多命令、参数和使用方式请查看:
项目包含基于 Python unittest 的自动化测试。
在项目根目录执行:
python -m unittest discover -s tests -v
现有测试共 51 项,均已通过。
自动化测试使用合成数据,验证业务处理、输出和渲染逻辑。
真实 MCP 查询和验证结果单独记录在:
其中包括真实数据查询的验证情况以及相关限制。
预览图片所使用的真实 MCP 快照日期为 2026 年 10 月 24 日,后续查询结果可能发生变化。
当前实现范围如下:
价格比较
只比较选定门店、同一商品和同一规格在当前测试方案下的报价。最多比较 3 家门店,不推断其他门店的价格。
优惠信息
按本人券包的有效日期统计券数,并展示已发布活动。适用时段、门店与商品条件另行处理。
营养计算
仅计算精确匹配的餐品。缺失字段单独说明,不使用其他商品的营养数据代替。额外展示的蔬菜、水果和奶类不计入本餐。
食用记录
订单查询结果先作为待确认信息。用户确认实际吃过后,才保存食用记录并点亮图鉴。探店记录同样需要用户确认。
自动化范围
项目不支持自动下单、付款或领取优惠券,也不提供云端同步和后台轮询。
图片与地图
体素场景由本地程序生成,仅用于信息展示。门店比价街道是示意场景,不包含真实道路或地理位置关系。
主要文件和目录如下:
Oh-My-McDonald/
├── oh-my-mcdonald/
│ ├── SKILL.md
│ ├── scripts/
│ │ └── oh_my_mcdonald.py
│ └── references/
│ └── commands.md
├── docs/
│ ├── images/
│ │ ├── overview.png
│ │ ├── gallery.png
│ │ ├── calendar.png
│ │ ├── compare.png
│ │ └── nutrition.png
│ └── VALIDATION.md
├── examples/
│ └── basket.json
├── tests/
├── requirements.txt
├── MCP_INTEGRATION.md
├── CONTEST_DECLARATION.md
└── LICENSE
其中:
SKILL.md 描述 AI 客户端如何使用项目。scripts/ 包含本地辅助脚本和渲染实现。references/ 提供命令使用参考。docs/images/ 存放场景预览图片。docs/VALIDATION.md 记录验证结果。MCP_INTEGRATION.md 介绍 MCP 接入和实际调用流程。CONTEST_DECLARATION.md 保留比赛官方声明原文。项目代码托管于 GitHub:
欢迎通过 Issues 反馈问题、提出建议,也欢迎通过 Pull Requests 参与改进。
本项目基于 MIT License 开源。
详细条款请查看仓库中的 LICENSE 文件。
基于麦当劳官方 MCP 的对话式 AI Skill,支持餐品推荐、门店比价、优惠查询、营养计算和探索记录,并通过 Python 生成体素风格分享图片。
เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Oh My McDonald ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-10-28 基于麦当劳官方 MCP 的对话式 AI Skill,支持餐品推荐、门店比价、优惠查询、营养计算和探索记录,并通过 Python 生成体素风格分享图片。