debuff — MCP-сервер для Claude Code: тесты и прогон 2D-игры
Даёт агенту доступ к живой игре: состояние, кадры, ошибки с объяснением, реплеи и фаззинг. Пригодится, когда нужно проверить механику, а не догадываться о ней.
claude mcp add debuff -- npx -y @debuffjp/mcpЧто делает debuff
Сервер подключается к игре через debuff dev или поднимает её приватную копию в headless-браузере. В live-режиме агент видит ту же вкладку, что и вы: пауза, шаг симуляции, смена параметров — всё попадает в журнал активности, откуда действие можно отменить. В headless время идёт только через game_step, поэтому картинка воспроизводима, а сценарий повторяет её шаг в шаг.
Инструментов много и они разбиты по задачам. inspect_project и list_assets показывают зависимости, плагины, ассеты и предупреждения. typecheck гоняет tsc самого проекта — Vite типы не проверяет, так что запускать его стоит после правок. build собирает прод и отдаёт отчёт по размеру, run_tests прогоняет логические тесты из tests/ прямо в Node, без браузера, а fuzz ищет краши и зацикливания и прикладывает сценарий для повтора. Отдельно есть game_frames с перцентилями и тремя самыми медленными кадрами, game_errors с разбором, чья это ошибка, и game_capture для PNG текущего кадра.
Запускать сервер нужно из папки игры либо указать --root <dir> или переменную DEBUFF_ROOT. Без этого он не поймёт, что тестировать. Новые проекты из npm create debuff уже содержат .mcp.json, и клиенты вроде Claude подхватывают сервер сами.
Какие задачи решает
- посмотреть состояние игры и текущий тик, не открывая браузер
- поймать краш или зацикливание случайным вводом и получить сценарий для повтора
- разобрать ошибку рантайма и понять, чей это баг
- проверить типы после правок, которые Vite пропускает
- снять PNG кадра для превью или картинки в магазин
Примеры запросов агенту
- Запусти
fuzzи покажи, на каком тике игра зациклилась - Сделай
game_startв headless и пройди десять шагов симуляции - Прогони
typecheckиbuild, покажи отчёт по размеру
Как установить debuff
Командой платформы
claude mcp add debuff -- npx -y @debuffjp/mcpКомандой платформы
codex mcp add mcp -- npx -y @debuffjp/mcpФайл настроек
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@debuffjp/mcp"
]
}
}
}Файл настроек
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@debuffjp/mcp"
]
}
}
}Командой платформы
gemini mcp add mcp npx -y @debuffjp/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о debuff
Как установить debuff в Claude Code?
Добавьте сервер командой claude mcp add debuff -- npx -y @debuffjp/mcp. Если ставите как плагин, сначала /plugin marketplace add debuffjp/debuff, затем /plugin install debuff@debuff — плагин заодно добавляет скилл с описанием рабочего процесса.
Что делает debuff?
Даёт агенту инструменты для работы с 2D-игрой на debuff: осмотр проекта и ассетов, сборка, тесты, фаззинг, пошаговый прогон и снимки кадров. Ошибки приходят с объяснением и указанием на строку исходника.
Чем live-режим отличается от headless?
В live агент цепляется к вашей открытой вкладке, а его паузы и шаги видны в журнале активности и отменяются. В headless он получает приватную копию, где время двигается только через game_step, зато результат воспроизводим.
