mcd-mcp-kit CLI
Проверяет подключение к MCP-серверу McDonald's China: число и имена инструментов, ответы на ошибки входа, причины нулевой цены.
- 121 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Клиент `mcd_mcp.py` способен вызвать инструменты, которые создают заказы и тратят баллы.
- Токен доступа к сервису хранится в переменной окружения.
Установка
- Работает в
Ручная установка
git clone https://github.com/CRFXN5C/mcd-mcp-kit.git && cd mcd-mcp-kit && python doctor.pyЕдинственная команда установки из README, нужен токен в `MCD_MCP_TOKEN`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Клиент `mcd_mcp.py` способен вызвать инструменты, которые создают заказы и тратят баллы.
- Токен доступа к сервису хранится в переменной окружения.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
mcd-mcp-kit — набор из двух скриптов на Python без внешних зависимостей для работы с MCP-сервером McDonald's China. `doctor.py` проверяет токен, рукопожатие `initialize`, число инструментов в `tools/list` и расхождения между документацией и реальными именами. Ключ `--probe-auth` показывает, какие коды и тела ответов сервер дает без токена и с неверным, а `--json` выводит результат для CI. Второй скрипт, `mcd_mcp.py`, служит минимальным клиентом: `tools` перечисляет инструменты, `call` вызывает выбранный, `demo` запускает только чтение, `raw` печатает заголовки рукопожатия. В репозитории также лежат `PITFALLS.md` с 13 найденными ловушками и `TOOLS.md` со списком из 35 инструментов.
Для кого. Разработчикам, которые подключают MCP McDonald's China к агенту или CI и хотят заранее увидеть расхождения документации с реальностью.
Подходит, если
- Новый токен выдан, и перед подключением к агенту проверяют, что сервер отвечает.
- Вызов `calculate-price` возвращает ноль, и ищут причину в названиях полей.
- Проверку доступности MCP вносят в CI через `doctor.py --json`.
- Читают, как сервер отвечает на отсутствующий и неверный токен.
Не подходит, если
- Нужен готовый MCP для агента: это скрипты диагностики, а не сервер.
- Автоматизируют заказы без контроля: клиент вызывает инструменты, которые тратят деньги и баллы.
- Требуется официальный продукт: проект независимый и к McDonald's не относится.
Пример запроса к агенту
Запусти `python doctor.py --probe-auth`, покажи число инструментов и расхождения с документацией, затем вызови `now-time-info`.Ограничения
Автор ведет проект как конкурсную работу и не связан с McDonald's. Ожидаемые значения, например 35 инструментов, привязаны к проверке 23 октября 2026 года: при изменениях сервера обновите `EXPECTED_TOOLS` в `doctor.py`. Токен выдают на open.mcd.cn/mcp по номеру телефона, README и тексты в основном на китайском. Через `mcd_mcp.py call` доступны и семь операций записи: заказ, отмена, дозаказ, адрес, лотерея, купоны и вечеринки.
Как отключить. Удалите клонированную папку и очистите переменную `MCD_MCP_TOKEN` в оболочке. Токен при необходимости отзовите в консоли open.mcd.cn.
Частые вопросы
Что проверяет `doctor.py`?
Токен, рукопожатие `initialize`, число инструментов в `tools/list`, названия из документации и реальные имена. Скрипт только читает и не создает заказов.
Как проверить ответы на ошибки входа?
Запустите `python doctor.py --probe-auth`. По README без токена сервер отвечает `403` с JSON, с неверным токеном `401` и обычным текстом.
Почему расчет цены дает 0 юаней?
Чаще всего передано не то имя поля, например `code` вместо `productCode`, и ошибки нет. Цены в ответах указаны в фэнях: 5900 означает 59 юаней.
Как встроить проверку в CI?
Используйте `python doctor.py --json`: поле `ok` показывает итог. Код выхода `2` означает ошибку.
Сколько у сервера инструментов?
По `TOOLS.md` их 35: 28 только читают, 7 меняют данные и тратят деньги или баллы. `doctor.py` эти семь не вызывает.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыКонсольный инспектор HTTP-серверов MCP: покажет инструменты, схемы, промпты и ресурсы и вызовет любой инструмент вручную.
Консольный отладчик MCP-серверов от Giant Swarm: REPL для инструментов, OAuth 2.1 и режим MCP-сервера для Cursor
Прозрачный прокси между ИИ-клиентом и MCP-сервером: показывает каждый кадр JSON-RPC в терминале, проверяет запись в CI и экспортирует спаны
Учебный MCP-сервер на Python: поиск по Hacker News, сведения о репозиториях GitHub и примеры запросов семплинга к модели
Локальный инструмент для проверки и отладки MCP-серверов: чат с инструментами, просмотр вызовов и прогоны оценок по разным клиентам
Легкий CLI, чтобы находить, смотреть и вызывать инструменты MCP-серверов прямо из командной строки
Коротко о README
Расхождения документации и сервера собраны в 13 пунктов с причиной, правильным действием и способом воспроизведения.