Laravel MCP

概要

Laravel MCPは、開発者がLaravelアプリケーション内で直接Model Context Protocol (MCP) サーバーを構築できるようにする、Laravelチームによって開発された公式パッケージです。2025年にLaravelのAIツールスイートの一部として発表され、サーバー、ツール、リソース、およびプロンプトを定義するための流暢でLaravelネイティブなインターフェースを提供します。これにより、あらゆるMCP互換のAIクライアント（Claude、ChatGPT、Cursor、GitHub Copilotなど）が、Laravelアプリケーションと安全かつ効率的に連携できるようになります。

Laravel MCPを統合することで、アプリケーションはAnthropicによって最初に導入され、現在はLinux Foundationの下で管理されているオープンなMCP標準に従って、カスタムAPIなしでAIエージェントに構造化された機能を公開できる能力を獲得します。

主な機能

-fs: 表現力豊かなサーバー定義: 属性と流暢なAPIを使用してサーバーメタデータ（名前、バージョン、指示）を設定します。

• ツール、リソース & プロンプト: 実行可能なツール、読み取り可能なリソース、再利用可能なプロンプトテンプレート用のカスタムクラスを登録します。

fs: Artisan スキャフォールディング: php artisan make:mcp-server で完全なMCPサーバースケルトンを生成します。

• Laravelネイティブ統合: Eloquent、キャッシュ、キュー、Sanctum認証、サービスコンテナを活用します。

fs: ストリーミングHTTP & SSEサポート: リアルタイムでスケーラブルな対話のための最新のMCPトランスポート上に構築されています。

• セキュリティ & 認証: Laravel SanctumまたはPassportとトークンベースの認証を容易に統合できます。
• テストサポート: ツールとサーバー動作のテストにPest/PHPUnitとシームレスに連携します。

インストール & クイックスタート

Composer経由でインストール:

composer require laravel/mcp

ルートと設定を公開（オプション）:

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

最初のサーバーを作成:

php artisan make:mcp-server WeatherServer

サーバークラスの例:

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

ユースケース

• AI 駆動開発ツール: Laravel 固有のコンテキスト（ルート、モデル、マイグレーション）を Claude Code や Cursor などのコーディングエージェントに公開。
• 業務アプリケーション統合: AI アシスタントが CRM データを照会したり、タスクを管理したり、e コマース機能と対話したりできるようにする。
• ローカルおよびリモートサーバー: 開発用にローカルで MCP サーバーを実行したり、本番 AI 統合用にリモートにデプロイしたり。
• マルチクライアント互換性: 1 つのサーバーが MCP をサポートする主要なすべての AI プラットフォーム（Anthropic、OpenAI、Google、Microsoft）で動作。

コミュニティのベンチマークによると、Laravel MCP により、AI 機能の統合時間がカスタムエンドポイントと比較して 5～8 倍短縮され、オープンプロトコルのおかげでベンダーロックインはゼロです。

高度なヒントとよくある落とし穴

• 本番サーバーでは Sanctum ミドルウェアを使用してツール実行を保護する。
• ツール呼び出しにレート制限を実装して悪用を防ぐ。
• 動的データ公開（例: Eloquent クエリ結果）にはリソーステンプレートを活用する。
• 落とし穴: ルートの登録を忘れる — 変更後は必ず php artisan route:cache を実行する。
• 高度な使い方: ローカル開発体験を向上させるため、Laravel Boost（別の公式 MCP サーバー）と組み合わせる。

まとめとリソース

Laravel MCP は、新興の AI エージェントエコシステムへの Laravel の公式コミットメントを表しています。2026年に MCP の採用が拡大する中、Laravel アプリに MCP サーバーを備えることは、AI ネイティブなインフラとしての位置付けを確立します。

今すぐ構築を始めましょう：

• 公式ドキュメント: https://laravel.com/docs/12.x/mcp
• GitHub: https://github.com/laravel/mcp
• デモアプリ Locket を探索: https://github.com/laravel/locket

パッケージに貢献するか、最初の MCP サーバーを構築してください — AI 支援による Laravel 開発の未来はここにあります。