Visão Geral

O Laravel MCP é o pacote oficial desenvolvido pela equipe do Laravel para permitir que desenvolvedores construam servidores de Model Context Protocol (MCP) diretamente dentro de aplicações Laravel. Lançado em 2025 como parte do conjunto de ferramentas de IA do Laravel, ele fornece uma interface fluida e nativa do Laravel para definir servidores, ferramentas, recursos e prompts que permitem que qualquer cliente de IA compatível com MCP (Claude, ChatGPT, Cursor, GitHub Copilot, etc.) interaja de forma segura e eficiente com sua aplicação Laravel.

Ao integrar o Laravel MCP, as aplicações ganham a capacidade de expor capacidades estruturadas para agentes de IA sem APIs personalizadas, seguindo o padrão MCP aberto originalmente introduzido pela Anthropic e agora administrado pela Linux Foundation.

Principais Recursos

Definição Expressiva de Servidor: Use atributos e APIs fluentes para configurar metadados do servidor (nome, versão, instruções).
Ferramentas, Recursos & Prompts: Registre classes personalizadas para ferramentas executáveis, recursos legíveis e modelos de prompt reutilizáveis.
Scaffolding Artisan: Gere esqueletos completos de servidor MCP com php artisan make:mcp-server.
Integração Nativa do Laravel: Aproveita Eloquent, cache, filas, autenticação Sanctum e o container de serviço.
Suporte a HTTP & SSE Transmissíveis: Construído sobre transportes MCP modernos para interações em tempo real e escaláveis.
Segurança & Autenticação: Fácil integração com Laravel Sanctum ou Passport para autenticação baseada em token.
Suporte a Testes: Funciona perfeitamente com Pest/PHPUnit para testar ferramentas e comportamento do servidor.

Instalação & Início Rápido

Instale via Composer:

composer require laravel/mcp

Publique rotas e configuração (opcional):

php artisan vendor:publish --tag=mcp-config
php artisan vendor:publish --tag=mcp-routes

Crie seu primeiro servidor:

php artisan make:mcp-server WeatherServer

Exemplo de classe de servidor:

<?php

namespace App\Mcp\Servers;

use Laravel\Mcp\Server;
use Laravel\Mcp\Server\Attributes\Name;
use Laravel\Mcp\Server\Attributes\Version;
use Laravel\Mcp\Server\Attributes\Instructions;

#[Name('Weather Server')]
#[Version('1.0.0')]
#[Instructions('Provides current weather and forecasts for locations worldwide.')]
class WeatherServer extends Server
{
    protected array $tools = [
        \App\Mcp\Tools\GetCurrentWeather::class,
    ];

    protected array $resources = [
        \App\Mcp\Resources\WeatherGuidelines::class,
    ];
}

Casos de Uso

Ferramentas de Desenvolvimento com IA: Expor contextos específicos do Laravel (rotas, modelos, migrações) para agentes de codificação, como Claude Code ou Cursor.
Integração de Aplicações de Negócio: Permitir que assistentes de IA consultem dados de CRM, gerenciem tarefas ou interajam com funcionalidades de e-commerce.
Servidores Locais e Remotos: Executar servidores MCP localmente para desenvolvimento ou implantá-los remotamente para integrações de IA em produção.
Compatibilidade Multi-Cliente: Um único servidor funciona em todas as principais plataformas de IA que suportam MCP (Anthropic, OpenAI, Google, Microsoft).

Os benchmarks da comunidade mostram que o Laravel MCP reduz o tempo de integração para funcionalidades de IA em 5–8× comparado a endpoints personalizados, com zero lock-in de fornecedor, graças ao protocolo aberto.

Dicas Avançadas e Armadilhas Comuns

Use o middleware Sanctum em servidores de produção para proteger a execução de ferramentas.
Implemente limitação de taxa (rate limiting) em chamadas de ferramentas para prevenir abusos.
Utilize templates de recursos para exposição dinâmica de dados (ex: resultados de consultas Eloquent).
Armadilha: Esquecer de registrar rotas — sempre execute php artisan route:cache após alterações.
Avançado: Combine com o Laravel Boost (outro servidor MCP de primeira parte) para uma experiência de desenvolvimento local aprimorada.

Conclusão e Recursos

O Laravel MCP representa o compromisso oficial do Laravel com o emergente ecossistema de agentes de IA. Conforme a adoção do MCP cresce em 2026, ter um servidor MCP em seu aplicativo Laravel o posiciona como uma infraestrutura nativa para IA.

Comece a construir hoje:

Documentação Oficial: https://laravel.com/docs/12.x/mcp
GitHub: https://github.com/laravel/mcp
Explore o aplicativo de demonstração Locket: https://github.com/laravel/locket

Contribua para o pacote ou construa seu primeiro servidor MCP — o futuro do desenvolvimento Laravel assistido por IA está aqui.