MCP-инструменты — справочник

Laravel 13 · laravel/boost ^2.0 Workflow Claude Code целиком: best/claude-code-workflow; Boost 2 (guidelines vs skills), Laravel PAO — best/laravel-13

Приоритет выбора (от дешёвого к дорогому)

1. laravel-boost (1% лимита) — структурированные компактные ответы
2. postgres/mysql MCP (6%) — SQL напрямую, минуя Docker
3. docker MCP (20%) — универсальный fallback
4. playwright (19%) — визуальная проверка, snapshot предпочтительнее screenshot

Bash docker exec — только TTY/interactive. Хуки блокируют неоптимальные вызовы.

Laravel Boost (mcp__laravel-boost__*)

Инструмент	Назначение	Вместо
last-error	Последняя ошибка в логе	docker exec + tail storage/logs
read-log-entries	Записи лога с фильтрацией	docker exec + cat/grep
database-schema	Структура таблиц/колонок/индексов	psql \d / SHOW CREATE TABLE
database-query	SELECT/INSERT/UPDATE к БД проекта	docker exec + psql -c
database-connections	Список коннекшнов	—
application-info	Laravel/PHP версии, пакеты	php artisan about
browser-logs	JS console из Telescope/Pail	Playwright вручную
search-docs	Laravel/Filament/Livewire документация	WebFetch на laravel.com
get-absolute-url	Корректные URL для тестов	—

Docker (mcp__docker__*)

Инструмент	Назначение
docker_exec	Artisan, composer, npm в контейнере
docker_list_containers	Состояние контейнеров (имена известны из CLAUDE.md — не вызывать лишний раз)
docker_inspect_container	Детали контейнера
docker_container_logs	Логи сервиса (всегда с tail: 20)
docker_compose_ps	Список compose-сервисов
docker_compose_restart	Перезапуск сервиса
docker_container_health_check	Health status
docker_container_stats	CPU/RAM мониторинг

Экономия Docker MCP

• Цепочка команд в одном docker_exec: cmd1 && cmd2 вместо 2 вызовов
• /compact после серии вызовов
• Предсказуемые команды (cache:clear) — не проверять вывод

PostgreSQL (mcp__postgres__*)

Для всех запросов к Postgres: быстрее, возвращает JSON, EXPLAIN-ready.

• SELECT для анализа данных
• Schema introspection
• Query planner — EXPLAIN для тяжёлых запросов
• Batch operations — bulk UPDATE/DELETE

MySQL (mcp__mysql__*)

Аналогично Postgres MCP для проектов на MySQL.

Playwright (mcp__playwright__*)

• browser_snapshot предпочтительнее browser_take_screenshot (легче по токенам)
• После 2-3 snapshot → /compact
• browser_console_messages с type: "error" для фильтрации
• Не делать screenshot если snapshot достаточен

Правила выбора

Задача	MCP
Ошибка Laravel	laravel-boost__last-error
Схема БД	laravel-boost__database-schema
SQL-запрос	postgres__query / mysql__query
Документация Laravel	laravel-boost__search-docs
Документация сторонних	context7__*
Artisan-команда	docker__docker_exec
Composer/npm	docker__docker_exec
Логи контейнера	docker__docker_container_logs (tail: 20)
Визуальная проверка	playwright__browser_snapshot
Поиск по коду	Grep/Glob (встроенные, бесплатно)

Настройка нового проекта

docker exec {app-container} composer require laravel/boost --dev   # Laravel 13 → boost ^2.0
docker exec {app-container} php artisan boost:install

Создать .mcp.json в корне проекта по образцу из CLAUDE.md.

• Гайдлайны Boost обновлять при апдейтах пакетов: php artisan boost:update --discover (можно повесить на composer post-update-cmd)
• Laravel PAO — dev-зависимость новых L13-приложений по умолчанию: определяет запуск PHPUnit/Pest/PHPStan/Artisan AI-агентом и отдаёт компактный JSON вместо прогресс-баров. Не удалять из dev-зависимостей — экономит токены и даёт агенту сразу failing assertion

Апгрейд Laravel 12 → 13 через Boost

Boost ^2.0 даёт slash-команду /upgrade-laravel-v13 прямо в Claude Code — guided-промпт официального апгрейда. Заявленное время апгрейда: ~10 минут (breaking changes минимальны). Перед запуском: бэкап БД, ветка, зелёные тесты.

«Тихие» риски апгрейда вне кода приложения (дефолтные CACHE_PREFIX/SESSION_COOKIE, polyfill array_first(), имена pagination-view) и чеклист — best/laravel-13.