mcd-desktop-pet CLI
Настольный питомец с командной строкой и скиллом: агент ведет стикеры на рабочем столе, а консоль вызывает MCP-сервис McDonald's
- 142 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Консоль от вашего имени вызывает сервис McDonald's: забирает купоны, тратит баллы в лотерее и читает данные учетной записи
- Агент через CLI создает и удаляет файлы стикеров на компьютере и запускает фоновую службу на порту 23301
- Исполняемые файлы скачиваются из релизов вручную, подписи по README нет
Установка
- Работает в
Ручная установка
Скачай релиз mcd-desktop-pet для своей системы со страницы https://github.com/kv-chiu/mcd-desktop-pet/releases и запусти `mcd-desktop-pet start`. Прочитай skill/SKILL.md в репозитории и копируй его в каталог скиллов агента. Стикеры создавай командой `mcd-desktop-pet note create --text "..."`, вывод разбирай как JSON.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Консоль от вашего имени вызывает сервис McDonald's: забирает купоны, тратит баллы в лотерее и читает данные учетной записи
- Агент через CLI создает и удаляет файлы стикеров на компьютере и запускает фоновую службу на порту 23301
- Исполняемые файлы скачиваются из релизов вручную, подписи по README нет
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
mcd-desktop-pet — настольный питомец «薯条小宝» для Windows и macOS: он живет в углу экрана, напоминает об обеде и открывает веб-консоль для работы с MCP-сервисом McDonald's. Консоль вызывает инструменты сервиса: собирает доступные купоны, показывает календарь акций, находит питательную ценность блюда по названию, проверяет баланс баллов и ищет ближайшие рестораны. В README указано 33 встроенных определения инструментов, а реально доступно то, что вернет сервис для вашей учетной записи. Для агентов в репозитории лежит скилл `skill/SKILL.md`, а тот же исполняемый файл работает как CLI. Команды `mcd-desktop-pet note create`, `note list`, `note archive` и `note restore` ведут стикеры на рабочем столе, а `start`, `stop`, `status` и `web` управляют питомцем и консолью. Каждая команда печатает чистый JSON в stdout, при ошибке выходит с ненулевым кодом и отдает `{"error": ...}`, поэтому Claude Code, Cursor или Codex разбирают ответ без дополнительных флагов.
Для кого. Офисным пользователям с аккаунтом McDonald's и разработчикам, которым нужен пример проекта, где агент через CLI управляет приложением на рабочем столе.
Подходит, если
- Агент записывает идеи и задачи стикерами прямо на рабочий стол, а выполненные потом архивирует
- Напоминание об обеде в 12:00 с заранее заданным временем, которое меняют через правое меню питомца
- Купоны и баллы McDonald's проверяют из веб-консоли, не заходя в приложение
- Разработчик изучает проект, где центр на Go, клиент на Godot, а веб-консоль на React связаны с анимацией питомца
Не подходит, если
- Сервис McDonald's недоступен вашей учетной записи: инструменты вернут только то, что разрешит официальный сервис
- Рабочая машина на Linux: в README описаны сборки только для Windows и macOS
- Агенту нужен отдельный MCP-сервер для подключения: проект сам ходит в сервис, а агенту отдает стикеры и управление питомцем
- По демонстрации заказа и доставки из README хочется оформить настоящий заказ: эти шаги собраны на заготовленных данных
Пример запроса к агенту
Запиши стикером на рабочий стол: в пятницу до конца дня закончить ревью документа, а потом покажи список активных стикеровОграничения
Проект подан на конкурс разработчиков McDonald's и не выпущен самой компанией; торговые марки и материалы принадлежат их владельцам. Шаги демо со скриншотов (купоны, подбор блюд, заказ, доставка) собраны из заготовленных данных. Набор инструментов зависит от ответа сервиса и прав учетной записи. Готовой команды установки нет: исполняемый файл скачивают вручную, папку skill/ копируют в каталог скиллов агента сами, а macOS при первом запуске просит подтвердить открытие в настройках безопасности.
Как отключить. Выполните `mcd-desktop-pet stop`, затем удалите скачанный файл или приложение и папку скилла из каталога агента.
Частые вопросы
Как поставить mcd-desktop-pet?
Скачайте исполняемый файл для Windows или приложение для macOS из релизов репозитория и запустите двойным щелчком. Запуск без аргументов равен команде `mcd-desktop-pet start`, поднимается фоновая служба и питомец. Для агента отдельно скопируйте папку skill/ в каталог скиллов.
Что вернет команда note list?
JSON-массив стикеров с полями id, summary и status. Параметр `--status` принимает active, archived или all, по умолчанию агент увидит активные стикеры на рабочем столе.
Это официальное приложение McDonald's?
Нет, автор называет его конкурсной работой независимого разработчика. Он вызывает MCP-сервис компании, а набор доступных инструментов определяет сам сервис и ваша учетная запись.
Как открыть веб-консоль McDonald's?
Щелкните правой кнопкой по питомцу и выберите пункт открытия веб-консоли, либо выполните `mcd-desktop-pet web`. Если служба не запущена, команда сама поднимет ее в фоне без питомца и откроет консоль в браузере.
Где менять время напоминания об обеде?
В правом меню питомца. Там есть готовые варианты 11:30, 12:00 и 12:30, а также произвольное время и число минут до напоминания. По умолчанию питомец напоминает за десять минут до 12:00.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP-сервер настольного питомца: статус сессий и расход токенов, купоны и заказы McDonald's и Luckin Coffee только с подтверждением
Настольный питомец, который реагирует на работу Claude Code, OpenCode и Cursor через хуки и MCP, не выводя в реплики код, пути и секреты
CLI и скилл для заказов McDonald's China: подбирают набор под калории, считают цену с купонами, держат заказ до подтверждения.
Настольный питомец и монитор в строке меню: видно, какой из кодинг-агентов работает, закончил или ждет вашего ответа
Подбирает полный заказ McDonald's Китая под бюджет и вкус по официальным ценам и выдает готовую карточку для заказа
Каталог анимированных питомцев для кодинг-агентов: CLI ставит питомца одной командой, а настольное приложение показывает его реакцию на действия агента
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| mcd-desktop-pet (эта карточка) | нет | 142 | ||
| mcd-cn-assistant | нет | API-ключ | 379 | скилл сравнивает меню и купоны McDonald's China, без питомца и стикеров |
| mcd-budget-meal | нет | 1 618 | скилл собирает меню под бюджет по MCP, без питомца и CLI |
Коротко о README
README на китайском и английском рассказывает о питомце, правом меню с напоминанием об обеде, веб-консоли и MCP-инструментах McDonald's. Дальше идут шаги быстрого старта с готовыми сборками и перечень файлов конкурсной заявки: декларация, описание MCP-интеграции и пример конфигурации с переменными окружения вместо ключей. В конце автор оговаривает лицензию MIT и что данные о питании и ценах нужно сверять с официальными каналами.