Laravel MCP - AI-взаимодействия по универсальному стандарту

Laravel MCP - это библиотека с публичной бета-версией, которая помогает разработчикам быстро создавать MCP-серверы внутри Laravel-приложений. Она уже использовалась на практике, например как часть AI-пакета Laravel Boost.

MCP-серверы дают любому искусственному интеллекту (например, ChatGPT, Claude, Cursor и другим) структурированный способ взаимодействовать с вашим приложением через единый протокол. Это значит, что AI-клиенты могут выполнять определённые задачи (например, создавать записи, получать данные, обрабатывать запросы) так же, как если бы это делал человек-разработчик через API.

Популярность MCP стремительно растёт, и стандартизированный подход к интеграции считается новым важным входным каналом для приложений наряду с веб-интерфейсами и API.

Основные возможности Laravel MCP

Вот что вы получаете с Laravel MCP:

Серверы

Сервер MCP - это центральная точка, через которую AI-клиент взаимодействует с вашим приложением. Каждый сервер определяет набор инструментов, ресурсов и шаблонов запросов, доступных AI.

Инструменты

Инструменты - это функции, которые AI может использовать, чтобы выполнять действия в приложении. Это может быть всё что угодно, от создания счёта до запуска фоновых задач.

Ресурсы

Ресурсы дают AI-клиенту доступ к структурированному содержимому вашего приложения. например документам, записям из базы данных, логам и т. д.

Шаблоны запросов (Prompts)

Шаблоны позволяют задавать повторно используемые, стандартизированные инструкции для AI. Вместо ручного ввода сложных запросов можно выбирать готовые шаблоны (например: "Оцени код").

Быстрый старт: установка и настройка

Установка

Добавьте Laravel MCP в проект с помощью Composer:

composer require laravel/mcp

Затем опубликуйте маршруты для MCP-серверов:

php artisan vendor:publish --tag=ai-routes

Это создаст файл routes/ai.php, в котором вы будете регистрировать свои MCP-серверы.

Создание MCP-сервера

Чтобы создать новый сервер, используйте Artisan-команду:

php artisan make:mcp-server WeatherServer

После этого внутри директории app/Mcp/Servers появится класс сервера, унаследованный от базового класса MCP. В нём вы сможете определить имя сервера, его версию, инструкции для AI и зарегистрировать набор инструментов, ресурсов и шаблонов.

Регистрация сервера

Сервер необходимо зарегистрировать в маршрутах (routes/ai.php), чтобы он стал доступен для AI-клиентов.

HTTP (Web) сервер

Это самый распространённый тип: доступ через HTTP POST-запросы.

use App\Mcp\Servers\WeatherServer;
use Laravel\Mcp\Facades\Mcp;

Mcp::web('/mcp/weather', WeatherServer::class);

Как и обычные маршруты Laravel, здесь можно применять middleware (например, для защиты или ограничения запросов).

Локальный сервер

Такой сервер работает как команда Artisan и может использоваться для локальных AI-интеграций, например с AI-ассистентами в IDE.

Mcp::local('weather', WeatherServer::class);

Большинство клиентов запускают такие сервера автоматически через свой собственный механизм, поэтому вручную запускать mcp:start обычно не нужно.

Совместимость и требования

Laravel MCP работает с Laravel 10, 11 и 12, требует PHP 8.1 или выше и по стилю использования полностью соответствует философии Laravel: понятный, выразительный и приятный API.

Laravel MCP предлагает новый путь внедрения AI-функций в приложения. Вместо хаотичных интеграций по HTTP API разработчики получают централизованную, типизированную инфраструктуру, стандартизированную вокруг Model Context Protocol.

Благодаря этому AI-ассистенты смогут не только читать данные, но и безопасно выполнять задачи, запускать логику приложения и взаимодействовать с самим Laravel-ядром в структурированном формате, почти как полноценный внутриигровой пользователь.