Laravel MCP-сервер Boost: установка в Claude Code, Codex и Cursor

laravel/boost· Проверено 12.11.2026· 3,7 тыс.на GitHub

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

Как подключить

Что сделать до подключения

1

PHP 8.2 или новее и проект на Laravel 12 или 13

2

В корне проекта: composer require laravel/boost --dev

3

Затем php artisan boost:install: команда выберет агентов, создаст .mcp.json, CLAUDE.md или AGENTS.md и навыки

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio laravel \
  -- php artisan boost:mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Инструменты сервера

database-schemaчитает таблицы, колонки, индексы и связи
database-queryвыполняет SQL только на чтение
database-connectionsперечисляет подключения к базам
last-errorпоказывает последнюю ошибку бэкенда
read-log-entriesчитает последние записи лога
browser-logsчитает ошибки консоли браузера
get-absolute-urlпревращает путь или маршрут в полный адрес
search-docsищет в документации под ваши версии
record-ruleзаписывает правило проекта в .ai/rules
tinkerвыполняет PHP в контексте приложения

Что попросить агента

«Запомни, что все денежные суммы храним в целых копейках, без float»Агент вызовет record-rule с маской файлов, заголовком и заметкой, Boost обновит .ai/rules/index.md
«Почему падает страница <адрес>? Посмотри последнюю ошибку и логи»Агент вызовет last-error, read-log-entries и browser-logs
«Покажи структуру таблицы orders и посчитай заказы за вчера»Агент вызовет database-schema с фильтром, затем database-query с SELECT
«Как в установленной версии Livewire сделать <задача>?»Агент вызовет search-docs: поиск идёт по документации пакетов, которые стоят в проекте
«Используй навык infer-conventions»Агент пройдёт по коду приложения и запишет найденные соглашения через record-rule

Для каких задач

Разобраться в схеме базы перед миграцией или новой моделью
Найти причину ошибки по последнему исключению и логам сервера и браузера
Проверить данные запросом SELECT без риска что-то записать
Найти в документации Laravel, Livewire, Inertia, Filament или Pest ответ под установленные версии
Запомнить правило проекта, например «деньги храним в целых копейках», чтобы его знали следующие агенты

Ограничения

!

Ставится пакетом в конкретный проект как dev-зависимость и требует PHP 8.2 и Laravel 12.41 или 13

!

database-query пропускает только SELECT, SHOW, EXPLAIN, DESCRIBE и WITH … SELECT, писать в базу агент не может

!

Инструмент tinker выполняет любой PHP в приложении и по умолчанию выключен: включается настройкой tinker_tool_enabled в config/boost.php

!

search-docs обращается к онлайн-API документации Laravel, без сети этот инструмент не работает

Если не работает

Claude Code не видит сервер laravel-boost
Откройте терминал в папке проекта и выполните claude mcp add -s local -t stdio laravel-boost php artisan boost:mcp.
Codex не подхватил Boost после установки
В папке проекта выполните codex mcp add laravel-boost -- php "artisan" "boost:mcp".

Частые вопросы

Что ставит boost:install кроме MCP-сервера?
Правила для агентов в CLAUDE.md, AGENTS.md и других файлах и навыки под пакеты из composer.json. Если CLAUDE.md уже есть, Boost меняет только свой блок <laravel-boost-guidelines>.
Нужно ли коммитить файлы Boost в репозиторий?
.mcp.json, файлы правил агентов и boost.json можно добавить в .gitignore: boost:install и boost:update пересоздают их. Папку .ai/rules с правилами проекта, наоборот, стоит коммитить.
Как обновить правила и навыки после обновления пакетов?
Выполните php artisan boost:update. Можно добавить @php artisan boost:update --ansi в post-update-cmd в composer.json, тогда обновление пойдёт само.
Как убрать инструмент record-rule?
Задайте в .env BOOST_RULES_ENABLED=false: инструмент пропадёт, и Boost перестанет вести папку .ai/rules.
Как установить Laravel MCP?
В корне проекта выполните composer require laravel/boost --dev, затем php artisan boost:install и выберите агентов. Вручную сервер регистрируется командой php с аргументами artisan boost:mcp.
Laravel Boost и laravel/mcp — одно и то же?
Это разные пакеты. Boost подключает laravel/mcp как зависимость и собирает на нём готовый сервер с инструментами для вашего приложения.
Работает ли сервер из России?
Сервер запускается внутри вашего проекта через php artisan, ключи не нужны; в сеть ходит только search-docs за документацией Laravel.

Похожие серверы