使用说明
mcd-desktop-pet
一只生活在电脑桌面角落的麦当劳“薯条小宝”桌面宠物。
它不仅能在你的桌面上闲庭漫步、接受摸头互动，还是一位麦麦生活管家——定时提醒午餐、一键领取优惠券、查询餐品营养信息，并通过网页控制台调用麦当劳 MCP 服务。项目目前内置 33 项工具定义，实际可用能力以官方服务返回及账号权限为准。
本项目为麦当劳程序员创意开发大赛参赛作品，由开发者独立开发，非麦当劳官方产品。
目标用户与使用场景
- 日常使用电脑的办公与学习用户：通过桌面陪伴和午休提醒，及时安排用餐与休息。
- 希望便捷获取麦当劳服务的用户：通过图形界面查询优惠券、活动、餐品营养和积分，减少手动组织工具参数的操作。
- 使用 AI Agent 的开发者：通过项目提供的 Skill 和 CLI，将自然语言需求转为 MCP 工具调用，并让桌宠展示业务反馈。
项目将 MCP 业务结果连接到桌宠动作与对话气泡，让信息查询和任务执行有直观反馈；网页控制台用于查看详细数据和手动调用工具。
| 步骤 1：午休提醒 | 步骤 2：优惠领券 | 步骤 3：餐品推荐 |
|---|---|---|
| 步骤 4：确认下单 | 步骤 5：配送动态 | 步骤 6：外卖送达 |
以上六步由模拟脚本驱动，优惠券、餐品推荐、下单、配送与送达均使用预设内容或模拟结果，复现方式见下文“模拟演示”。
桌面宠物：薯条小宝
薯条小宝会静静地在桌面陪伴你，带来轻松有趣的工作与休闲氛围：
互动与表演
- 互动动画：鼠标左键轻点小宝，它会开心地向上弹跳，并冒出元气满满的对话气泡。在闲暇时，它会在桌面边走边散步。
- 动作随心控：在小宝身上点击鼠标右键，可以随时命令它“散步走走”、“停下休息”、“开怀跳跃”或“挥手打招呼”。
- 自由拖拽：按住鼠标左键即可随时将它移至屏幕任意位置，不影响你的日常打字与办公。
贴心午餐提醒
- 饭点报时：内置智能午餐闹钟，默认每天 12:00 提前 10 分钟提醒你该选餐休息啦。
- 个性化设置：右键菜单中支持快速选择 11:30、12:00、12:30 等多个预设时段，也可以输入任意自定义时间与提前提醒分钟数。
- 即时测试：在右键菜单中点击“立即测试午休提醒”，随时预览小宝的报时与互动动作。
视窗设计
- 全屏显示设置：支持右键开启和关闭“在全屏应用中显示桌宠”，是否让小宝陪你全屏看视频或沉浸办公，由你选择。
配套图形控制台 (Web Console)
如果你需要更深度的麦当劳服务，只需在桌宠身上右键选择 “打开 Web 控制台”，即可一键呼出图形化管理界面：
控制台提供以下 MCP 工具入口，调用结果由麦当劳官方服务返回：
- 一键省钱领券：自动领取当前可用的麦当劳麦麦省券，并可随时查看手头卡券列表与到期日期。
- 当季活动日历：同步当月麦当劳最新的营销日历，随时了解即将开启的促销与限定新品。
- 餐品营养速查：输入餐品关键词，查看官方返回的能量、蛋白质、脂肪等营养信息。
- 积分与周边商城：快速查看账户麦当劳积分余额，参与在线积分抽奖与周边兑换。
- 附近门店与点餐：快速查询周边可用的麦当劳门店及支持的服务状态。
- 更多工具：主题活动预约、订单查询等，完整内置工具清单见 MCP 接入说明。
Web 控制台的常规工具调用通过本地中枢连接麦当劳 MCP，真实调用与模拟入口的区别见 MCP 接入说明。项目架构和流程还在优化中，欢迎提出 Issue 和 PR。
快速上手指南
1. 下载与极简启动 (零环境依赖)
系统提供编译型一体化分发物，下载解压即可点击使用：
- Windows 用户：下载
mcd-desktop-pet.exe单可执行文件，直接双击运行。桌宠将自动在桌面就席，常驻内存仅约 15MB。 - macOS 用户：下载
mcd-desktop-pet.app单应用包，解压后拖入/Applications文件夹，直接双击打开（首次启动如遇系统安全提示，可在“系统设置 -> 隐私与安全性”中点击“仍要打开”）。
💡 启动即服务：双击运行或终端无参数运行严格等同于
mcd-desktop-pet start。点击运行与命令行共用同一套底层生命周期调度，自动拉起极轻量 Go 中枢后台服务与桌宠表现层；若已在运行则自动复用已有实例，避免重复创建。
参赛材料
| 文件 | 内容 |
|---|---|
| README.md | 项目介绍、目标用户、安装方法与使用示例 |
| CONTEST_DECLARATION.md | 官方参赛声明，保留原始内容 |
| MCP_INTEGRATION.md | MCP Server、工具、调用流程、业务价值与验证方法 |
| mcp-config.example.json | 仅用环境变量占位符配置地址与凭证的 MCP 配置示例 |
许可证
项目代码基于 MIT License 开源。麦当劳相关商标与素材的权利归其权利人所有，不因代码许可证而转移。项目输出仅供参考，不构成医疗、营养或其他专业建议；餐品信息、价格及供应状态以麦当劳官方渠道的实时结果为准。
