holdcloud/mcd-calendar-buddy

选用指南

AI 根据 README 整理 · 2026/10/25 18:26:07

目标用户

面向喜欢麦当劳、使用macOS日历管理日程、希望通过自然语言一句话搞定信息整理的效率党。

查看 README 依据

3. 一键同步写入 **macOS 日历（Calendar.app）**，到点自动弹窗提醒。 示例场景：*"帮我把麦当劳最近两周的活动都加到日历里，活动开始前一天提醒我"* —— 助手查询活动日历 → 生成事件 → 写入系统日历，完成。 ## 目标用户 - 喜欢麦当劳、不想错过优惠和限定活动的用户 - 使用 macOS 日历管理日程、依赖提醒通知的用户 - 希望通过自然语言一句话搞定信息整理的效率党 ## 安装方法 项目**零第三方依赖**，仅需 Python 3.10+。 ```bash # 1. 克隆仓库 git clone https://github.com/<你的用户名>/mcd-calendar-buddy.git cd mcd-calendar-buddy # 2. 配置麦当劳 MCP Token（获取方式：麦当劳 MCP 官网 → 登录 → 控制台 → 激活） export MCD_MCP_TOKEN="你的麦当劳MCP Token" # macOS / Linux setx MCD_MCP_TOKEN "你的麦当劳MCP Token" # Windows # 3. 运行 python src/cli.py query # 查询当月麦当劳活动

使用方式

通过命令行使用，提供query、sync、export、schedule等子命令，支持关键词过滤和导出.ics文件。

查看 README 依据

3. 一键同步写入 **macOS 日历（Calendar.app）**，到点自动弹窗提醒。 示例场景：*"帮我把麦当劳最近两周的活动都加到日历里，活动开始前一天提醒我"* —— 助手查询活动日历 → 生成事件 → 写入系统日历，完成。 ## 目标用户 - 喜欢麦当劳、不想错过优惠和限定活动的用户 - 使用 macOS 日历管理日程、依赖提醒通知的用户 - 希望通过自然语言一句话搞定信息整理的效率党 ## 安装方法 项目**零第三方依赖**，仅需 Python 3.10+。 ```bash # 1. 克隆仓库 git clone https://github.com/<你的用户名>/mcd-calendar-buddy.git cd mcd-calendar-buddy # 2. 配置麦当劳 MCP Token（获取方式：麦当劳 MCP 官网 → 登录 → 控制台 → 激活） export MCD_MCP_TOKEN="你的麦当劳MCP Token" # macOS / Linux setx MCD_MCP_TOKEN "你的麦当劳MCP Token" # Windows # 3. 运行 python src/cli.py query # 查询当月麦当劳活动

python src/cli.py query --filter 联名,新品 # 关键词订阅过滤 python src/cli.py sync # 同步到 macOS 日历（智能提醒） python src/cli.py export -o mc.ics # 导出 .ics（任何平台可用） python src/cli.py schedule # 生成 macOS 每日定时同步任务 ``` macOS 权限说明：首次 `sync` 写入日历时，系统会请求「日历」自动化权限，请在 系统设置 > 隐私与安全性 > 自动化 中允许；Windows/Linux 等平台会自动降级为导出 `.ics` 文件，双击导入即可。 ## 🤖 一句话安装（AI Agent 友好） 本项目**零依赖、README 即全部文档**，天生适合直接丢给你的 AI 助手安装。打开任意 Agent，粘贴一句话： **WorkBuddy / 豆包 / Kimi 等对话智能体：** ```text 请根据 https://github.com/holdcloud/mcd-calendar-buddy 的 README 帮我安装 「麦麦日历助手」：克隆仓库 → 指导我申请并配置麦当劳 MCP Token → 把本月

部署要求

需要Python 3.10+，零第三方依赖，需配置麦当劳MCP Token。macOS首次同步需授予日历自动化权限。

查看 README 依据

3. 一键同步写入 **macOS 日历（Calendar.app）**，到点自动弹窗提醒。 示例场景：*"帮我把麦当劳最近两周的活动都加到日历里，活动开始前一天提醒我"* —— 助手查询活动日历 → 生成事件 → 写入系统日历，完成。 ## 目标用户 - 喜欢麦当劳、不想错过优惠和限定活动的用户 - 使用 macOS 日历管理日程、依赖提醒通知的用户 - 希望通过自然语言一句话搞定信息整理的效率党 ## 安装方法 项目**零第三方依赖**，仅需 Python 3.10+。 ```bash # 1. 克隆仓库 git clone https://github.com/<你的用户名>/mcd-calendar-buddy.git cd mcd-calendar-buddy # 2. 配置麦当劳 MCP Token（获取方式：麦当劳 MCP 官网 → 登录 → 控制台 → 激活） export MCD_MCP_TOKEN="你的麦当劳MCP Token" # macOS / Linux setx MCD_MCP_TOKEN "你的麦当劳MCP Token" # Windows # 3. 运行 python src/cli.py query # 查询当月麦当劳活动

python src/cli.py query --filter 联名,新品 # 关键词订阅过滤 python src/cli.py sync # 同步到 macOS 日历（智能提醒） python src/cli.py export -o mc.ics # 导出 .ics（任何平台可用） python src/cli.py schedule # 生成 macOS 每日定时同步任务 ``` macOS 权限说明：首次 `sync` 写入日历时，系统会请求「日历」自动化权限，请在 系统设置 > 隐私与安全性 > 自动化 中允许；Windows/Linux 等平台会自动降级为导出 `.ics` 文件，双击导入即可。 ## 🤖 一句话安装（AI Agent 友好） 本项目**零依赖、README 即全部文档**，天生适合直接丢给你的 AI 助手安装。打开任意 Agent，粘贴一句话： **WorkBuddy / 豆包 / Kimi 等对话智能体：** ```text 请根据 https://github.com/holdcloud/mcd-calendar-buddy 的 README 帮我安装 「麦麦日历助手」：克隆仓库 → 指导我申请并配置麦当劳 MCP Token → 把本月

已知限制

非麦当劳官方产品，活动信息以官方渠道实时结果为准。Windows/Linux平台自动降级为导出.ics文件。

查看 README 依据

python src/cli.py query --filter 联名,新品 # 关键词订阅过滤 python src/cli.py sync # 同步到 macOS 日历（智能提醒） python src/cli.py export -o mc.ics # 导出 .ics（任何平台可用） python src/cli.py schedule # 生成 macOS 每日定时同步任务 ``` macOS 权限说明：首次 `sync` 写入日历时，系统会请求「日历」自动化权限，请在 系统设置 > 隐私与安全性 > 自动化 中允许；Windows/Linux 等平台会自动降级为导出 `.ics` 文件，双击导入即可。 ## 🤖 一句话安装（AI Agent 友好） 本项目**零依赖、README 即全部文档**，天生适合直接丢给你的 AI 助手安装。打开任意 Agent，粘贴一句话： **WorkBuddy / 豆包 / Kimi 等对话智能体：** ```text 请根据 https://github.com/holdcloud/mcd-calendar-buddy 的 README 帮我安装 「麦麦日历助手」：克隆仓库 → 指导我申请并配置麦当劳 MCP Token → 把本月

├── calendar_sync.py # macOS 日历写入 + .ics 导出 + 智能提醒 └── cli.py # 命令行入口（query/sync/export/schedule） ``` ## 参赛声明 本项目为麦当劳程序员节创意开发大赛参赛作品，非麦当劳官方产品。活动信息以麦当劳官方渠道实时结果为准，详见 [CONTEST_DECLARATION.md](CONTEST_DECLARATION.md)。 ## 许可证 MIT License