# Laravel MCP

Laravel向け公式Model Context Protocol（MCP）サーバー構築パッケージ。ツール、リソース、プロンプトを通じて、AIクライアントとLaravelアプリケーションのシームレスな連携を実現します。

Canonical URL: https://a2a-mcp.org/entry/laravel-mcp-ja

Language: ja

Category: MCP Servers

Updated: 2026-03-24

## 概要

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経由でインストール:

```bash
composer require laravel/mcp
```

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

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

最初のサーバーを作成:

```bash
php artisan make:mcp-server WeatherServer
```

サーバークラスの例:

```php
<?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 開発の未来はここにあります。

## Tags

- laravel
- mcp
- ai
- php
- サーバー
- モデルコンテキストプロトコル
- ツール
- リソース
- プロンプト

## Sources

- [Project website](https://github.com/laravel/mcp)
