Laravel MCP

Übersicht

Laravel MCP ist das offizielle Paket, das vom Laravel-Team entwickelt wurde, um Entwicklern die Möglichkeit zu geben, Model Context Protocol (MCP) |Server direkt innerhalb von Laravel-Anwendungen zu erstellen. Es wurde 2025 als Teil der Laravel AI-Tooling-Suite eingeführt und bietet eine fließende, Laravel-native Schnittstelle zur Definition von Servern, Tools, Ressourcen und Prompts, die es jedem MCP-kompatiblen AI-Client (Claude, ChatGPT, Cursor, GitHub Copilot, etc.) ermöglichen, sicher und effizient mit Ihrer Laravel-App zu interagieren.

Durch die Integration von Laravel MCP erhalten Anwendungen die Fähigkeit, strukturierte Funktionen für KI-Agenten verfügbar zu machen, ohne benutzerdefinierte APIs zu benötigen, und folgen dabei dem offenen MCP-Standard, der ursprünglich von Anthropic eingeführt wurde und nun unter der Linux Foundation verwaltet wird.

Hauptmerkmale

• Ausdrucksstarke Serverdefinition: Verwenden Sie Attribute und fließende APIs, um Server-Metadaten (Name, Version, Anweisungen) zu konfigurieren.
• Tools, Ressourcen & Prompts: Registrieren Sie benutzerdefinierte Klassen für ausführbare Tools, lesbare Ressourcen und wiederverwendbare Prompt-Vorlagen.
• Artisan-Gerüstbau: Generieren Sie vollständige MCP-Server-Skelette mit php artisan make:mcp-server.
• Laravel-Native-Integration: Nutzt Eloquent, Caching, Queues, Sanctum-Authentifizierung und den Service Container.
• Streamable HTTP & SSE-Unterstützung: Basiert auf modernen MCP-Transports für Echtzeit-Interaktionen und Skalierbarkeit.
• Sicherheit & Authentifizierung: Einfache Integration mit Laravel Sanctum oder Passport für tokenbasierte Authentifizierung.
• Testunterstützung: Funktioniert nahtlos mit Pest/PHPUnit zum Testen von Tools und Serververhalten.

Installation & Schnellstart

Installation via Composer:

composer require laravel/mcp

Routen und Konfiguration veröffentlichen (optional):

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

Erstellen Sie Ihren ersten Server:

php artisan make:mcp-server WeatherServer

Beispiel-Serverklasse:

<?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,
    ];
}

Anwendungsfälle

• KI-gestützte Entwicklungswerkzeuge: Laravel-spezifischen Kontext (Routen, Modelle, Migrationen) für Coding-Agenten wie Claude Code oder Cursor verfügbar machen.
• Integration von Geschäftsanwendungen: KI-Assistenten ermöglichen, CRM-Daten abzufragen, Aufgaben zu verwalten oder mit E-Commerce-Funktionen zu interagieren.
• Lokale & Remote-Server: MCP-Server lokal für die Entwicklung betreiben oder remote für Produktions-KI-Integrationen bereitstellen.
• Multi-Client-Kompatibilität: Ein Server funktioniert mit allen großen KI-Plattformen, die MCP unterstützen (Anthropic, OpenAI, Google, Microsoft).

Community-Benchmarks zeigen, dass Laravel MCP die Integrationszeit für KI-Funktionen im Vergleich zu benutzerdefinierten Endpunkten um das 5- bis 8-fache reduziert, ohne Vendor-Lock-in dank des offenen Protokolls.

Fortgeschrittene Tipps & Häufige Fallstricke

• Verwenden Sie Sanctum-Middleware für Produktionsserver, um die Werkzeugausführung zu sichern.
• Implementieren Sie Ratenbegrenzung für Werkzeugaufrufe, um Missbrauch zu verhindern.
• Nutzen Sie Ressourcenvorlagen für die dynamische Dateneinbindung (z. B. Eloquent-Abfrageergebnisse).
• Fallstrick: Das Registrieren von Routen vergessen – führen Sie nach Änderungen immer php artisan route:cache aus.
• Fortgeschritten: Kombinieren Sie mit Laravel Boost (einem weiteren First-Party-MCP-Server) für ein verbessertes lokales Entwicklungserlebnis.

Fazit & Ressourcen

Laravel MCP steht für Laravels offizielles Engagement im aufstrebenden KI-Agenten-Ökosystem. Da die MCP-Adoption 2026 wächst, positioniert ein MCP-Server in Ihrer Laravel-App diese als KI-native Infrastruktur.

Beginnen Sie noch heute mit dem Aufbau:

• Offizielle Dokumentation: https://laravel.com/docs/12.x/mcp
• GitHub: https://github.com/laravel/mcp
• Erkunden Sie die Demo-App Locket: https://github.com/laravel/locket

Tragen Sie zum Paket bei oder bauen Sie Ihren ersten MCP-Server – die Zukunft der KI-unterstützten Laravel-Entwicklung ist da.