Laravel Boost: MCP-сервер для AI-разработки на Laravel — установка и практика — PROG-TIME

Laravel Boost: MCP-сервер для AI-разработки на Laravel — установка и практика

02.06.2026

Большие языковые модели неплохо пишут PHP — данных для обучения хватает. Но без контекста о вашем конкретном проекте агент начинает выдумывать несуществующие методы, путать идиомы фреймворка и игнорировать тесты. Особенно это заметно, когда модель «знает» Laravel вообще, но не знает, какая именно у вас версия Inertia, Livewire или самого фреймворка. Laravel Boost — официальный пакет от команды Laravel, который закрывает эту дыру в контексте: он поднимает локальный MCP-сервер, даёт агенту инструменты для работы с реальным состоянием приложения и подсовывает версионную документацию. В этой статье разберём, что такое Boost, как его поставить и какие практические задачи он решает.

Что такое MCP и при чём тут Boost

MCP (Model Context Protocol) — это протокол, через который AI-агент общается с внешними инструментами: вызывает функции, читает данные, выполняет команды. Вместо того чтобы угадывать структуру вашей БД или сигнатуру метода, агент может буквально спросить у сервера: «какие есть маршруты?», «покажи схему таблицы users», «выполни этот код в Tinker». Boost — это Laravel-ориентированный MCP-сервер, который запускается прямо внутри вашего проекта и превращает агента из «поисковика по памяти» в подобие опытного Laravel-разработчика, видящего реальное приложение.

Boost вышел в публичную бету 13 августа 2025 года, через две недели после анонса на Laracon US 2025. Пакет бесплатный, с открытым исходным кодом под лицензией MIT, и активно развивается — на момент написания статьи актуальна ветка релизов 2.x.

Требования и установка

Boost поддерживается в Laravel 10, 11 и 12 на PHP 8.1 и выше. Важный нюанс: пакет ставится только как dev-зависимость и работает исключительно на машине разработчика. На прод он не попадает и никак не влияет на сборку.

composer require laravel/boost --dev

После установки запускаем интерактивный установщик:

php artisan boost:install

Команда задаёт два ключевых вопроса. Первый — какие компоненты вам нужны: AI-гайдлайны, скиллы и MCP-сервер. Второй — какими AI-агентами вы пользуетесь. Установщик автоматически детектит, что уже подключено в репозитории, и предлагает варианты вроде Cursor, Claude Code, Codex, Gemini CLI, GitHub Copilot и Junie. По итогу Boost генерирует конфигурацию MCP и файлы гайдлайнов под выбранные инструменты.

Ключевая особенность установщика — он не навязывает свои правила стиля существующим проектам по умолчанию. Стоит просмотреть, что именно он собирается добавить, и включить только то, что имеет смысл для вашей команды.

15+ инструментов MCP: что получает агент

Главная ценность Boost — набор из более чем 15 инструментов, которые MCP-сервер выставляет агенту. Они позволяют рассуждать, опираясь на реальное состояние приложения, а не на догадки. Среди них:

  • application-info — общая информация о приложении: версии PHP, Laravel и установленных пакетов;
  • search-docs — поиск по версионной документации экосистемы Laravel;
  • tinker — выполнение произвольного PHP-кода в контексте приложения;
  • database-query и database-schema — запросы к БД и инспекция схемы;
  • list-routes, list-artisan-commands — список маршрутов и доступных команд;
  • read-log-entries, last-error — чтение логов и последней ошибки приложения;
  • browser-logs — чтение логов браузера из storage/logs/browser.log;
  • get-config — чтение значений конфигурации;
  • report-feedback — отправка фидбэка о работе Boost прямо из редактора.

Например, вместо того чтобы спрашивать у вас структуру таблицы, агент сам вызовет схему:

// Агент через MCP запрашивает схему таблицы
// Tool: database-schema
// → возвращает колонки, типы, индексы и связи

// А затем может создать фикстуры через Tinker:
User::factory()->count(5)->create([
    'email_verified_at' => now(),
]);

Документация, привязанная к версиям

Отдельный козырь Boost — Documentation API на основе более чем 17 000 векторизованных фрагментов документации экосистемы Laravel. Команда заранее разбивает и индексирует доки, поэтому агент получает подсказки, привязанные к конкретным мажорным версиям ваших пакетов. На практике это значит, что для приложения с Livewire 3 агент не предложит синтаксис из Livewire 2, а для нужной версии Inertia подберёт правильный API.

AI Guidelines: правила вместо хаоса

Boost устанавливает поддерживаемые командой Laravel гайдлайны — это композируемые, версионно-специфичные правила, которые подталкивают агента следовать конвенциям проекта, использовать правильные API и писать тесты там, где это уместно. Гайдлайны генерируются с учётом установленных пакетов и их версий, поэтому набор правил для вашего проекта отличается от набора для соседнего.

Практический сценарий: «белый экран смерти»

Допустим, после деплоя страница отдаёт белый экран. С Boost диалог с агентом выглядит так: он вызывает last-error, чтобы получить последнюю ошибку Laravel, читает свежие записи через browser-logs, находит опечатку или неверный вызов и предлагает фикс — уже с учётом вашей версии фреймворка. По итогам внутреннего тестирования команда Laravel отмечала, что агенты использовали поиск по докам для нахождения корректного API под точную версию пакета, инспектировали схему БД, создавали фикстуры через Tinker и читали браузерные логи для триажа фронтенд-ошибок. Результат — меньше галлюцинаций и меньше времени на вычистку «творчества» модели.

Похожий выигрыш виден на типовых задачах: попросить агента добавить rate limiting — и получить реализацию под вашу версию Laravel плюс тесты, а не абстрактный пример из интернета.

Ограничения беты

Boost остаётся в публичной бете, поэтому стоит держать в голове несколько вещей. Документация индексируется на уровне мажорных версий — если ваш код завязан на различия минорных или патч-релизов, сгенерированный код нужно перепроверять. И главное правило: каким бы убедительным ни выглядел вывод, относитесь к нему как к черновику. Прогоняйте тесты, читайте диффы, делайте код-ревью обязательным этапом. Boost снижает рутину и количество ошибок, но не заменяет инженерное суждение.

Итоги

Laravel Boost решает конкретную и болезненную проблему — нехватку контекста у AI-агентов при работе с реальным Laravel-проектом. Связка из локального MCP-сервера с 15+ инструментами, версионной документации на 17 000+ фрагментов и поддерживаемых гайдлайнов делает вывод модели заметно точнее и пригоднее для ревью. Установка занимает пару минут (composer require laravel/boost --dev и php artisan boost:install), пакет бесплатный, ничего не тянет в прод и поддерживает Laravel 10–12 на PHP 8.1+. Если вы уже используете Cursor, Claude Code или другого агента в Laravel-проекте — Boost стоит попробовать в первую очередь, помня про дисциплину код-ревью.