McPerks Planner — скилл
Навык для WorkBuddy над официальным MCP McDonald's ранжирует купоны и баллы по срочности и сверяет цену с расчетом сервера.
- 121 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Навык читает данные аккаунта через токен MCP; заказы и обмен выполняются только после подтверждения.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/mcperks-plannerОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Навык читает данные аккаунта через токен MCP; заказы и обмен выполняются только после подтверждения.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Навык берет данные официального MCP McDonald's и превращает их в понятный план. Модуль инвентаризации собирает купоны, доступные для получения купоны, баллы и акции и делит их на пригодные, скоро истекающие и без срока. Модуль планирования расставляет предложения по срочности и консервативной оценке экономии в пределах бюджета на один день или несколько. Модуль расчета берет итоговую цену из ответа `calculate-price`, переводя фэни в юани, и отделяет оценку от фактической суммы. Модуль акций связывает события с купонами и блюдами, а будущие акции помечает как ожидающие подтверждения. Ядро алгоритмов не связано с сетью, поэтому результаты воспроизводимы. Команды `inventory`, `plan`, `reprice`, `campaigns`, `compare` и `demo` запускаются и без WorkBuddy. По умолчанию навык только читает и планирует; заказ, получение купона и обмен спрашивает у человека.
Для кого. Пользователям McDonald's в Китае и разработчикам, которым нужен пример навыка с детерминированными расчетами поверх MCP.
Подходит, если
- Купоны и баллы близки к истечению, и их нужно упорядочить по срочности.
- В бюджете на неделю подбирают предложения с наибольшей консервативной экономией.
- Рекомендованная цена расходится с ценой при оформлении, и нужен точный расчет.
- Демонстрацию навыка запускают без токена командой `demo`.
Не подходит, если
- Нужен сервис за пределами Китая.
- Агенту хотят доверить заказы без подтверждения человека.
- Ожидают официальный продукт McDonald's: проект независимый, конкурсная работа.
Пример запроса к агенту
Покажи купоны и баллы по срочности, составь план на три дня с бюджетом 100 юаней и сверь цену через `calculate-price`.Ограничения
Проект выпущен как работа на конкурс программистов, это не продукт McDonald's, вывод носит справочный характер. Рассчитан на WorkBuddy и китайский MCP, документация на китайском. Для реальных данных нужен токен MCP, который хранится только в настройках коннектора. Часть дат у акций неизвестна, такие позиции помечаются как ожидающие. Прямой клиент MCP в `mcp_adapter.py` необязателен. Для запуска тестов нужен `pytest`, остальное работает на стандартной библиотеке Python 3.12 и новее. Последний коммит от октября 2026 года.
Как отключить. Отключите коннектор MCP в WorkBuddy и удалите папку навыка. Токен хранится в настройках коннектора, его отзывают в консоли MCP.
Частые вопросы
Можно ли попробовать без токена?
Да, команда `python -m mcperks.cli demo` показывает пример работы без токена и без обращений к сети.
Как навык отличает оценку от фактической цены?
Фактическая сумма берется из ответа `calculate-price`, оценка помечается отдельно. Так видно расхождение между рекомендацией и оформлением.
Что умеет командная строка?
Подкоманды `inventory`, `plan`, `reprice`, `campaigns`, `compare` и `demo` читают JSON с входными данными и печатают результат.
Оформляет ли навык заказы сам?
Нет. По умолчанию он только запрашивает и планирует, а заказ, купон и обмен подтверждаются у человека.
Это официальный продукт?
Нет, работа независимого разработчика для конкурса. Актуальные цены и наличие определяются официальными ответами McDonald's.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыНавык для WorkBuddy и официального MCP McDonald's: считает купоны и баллы, собирает заказ и защищает розыгрыши журналом.
Скилл для WorkBuddy читает купоны и баллы McDonald's через MCP и составляет до двух проверенных вариантов заказа по бюджету.
Навык для WorkBuddy считает калории заказов McDonald's за месяц и собирает здоровый набор на следующий обед.
Результаты не демо: цены и меню идут прямым вызовом официального MCP вендора и меняются день в день.
Скилл заказа в McDonald's China через официальный MCP: цены с купонами, состав, статус заказа и тихий итог без оценок еды.
Скилл для WorkBuddy ищет рестораны и купоны через официальный MCP McDonald's Китая и находит самое дешевое сочетание блюд.
Коротко о README
Архитектура описана слоями: разговор по `SKILL.md`, вызовы MCP, разбор ответов и детерминированные расчеты. Автор отказывается от базы данных, Docker и Redis.