Laravel MCP

概述

Laravel MCP 是 Laravel 團隊開發的官方套件，旨在讓開發者能夠直接在 Laravel 應用中建構 模型情境協定 (MCP) 伺服器。作為 Laravel AI 工具套件的一部分於 2025 年推出，它提供了一個流暢、原生於 Laravel 的介面，用於定義伺服器、工具、資源和提示，使任何與 MCP 相容的 AI 客戶端（Claude、ChatGPT、Cursor、GitHub Copilot 等）能夠安全且高效地與您的 Laravel 應用程式互動。

透過整合 Laravel MCP，應用程式能夠遵循最初由 Anthropic 提出、現由 Linux 基金會管理的開放式 MCP 標準，向 AI 代理程式揭露結構化的能力，而無需自訂 API。

主要功能

• 表達式伺服器定義：使用屬性和流暢的 API 來配置伺服器中繼資料（名稱、版本、指令）。
• 工具、資源與提示：註冊可執行工具、可讀取資源和可重複使用提示範本的自訂類別。
• Artisan 腳手架：使用 php artisan make:mcp-server 生成完整的 MCP 伺服器骨架。
• Laravel 原生整合：運用 Eloquent、快取、佇列、Sanctum 認證和服務容器。
• 可串流的 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 驅動的開發工具：向 Claude Code 或 Cursor 等編碼代理提供 Laravel 相關上下文（路由、模型、遷移）。
• 商業應用整合：讓 AI 助理查詢 CRM 數據、管理任務，或與電子商務功能互動。
• 本地與遠端伺服器：在本地運行 MCP 伺服器進行開發，或部署遠端伺服器進行生產環境的 AI 整合。
• 多客戶端兼容性：一個伺服器即可支援所有主要支援 MCP 的 AI 平台（Anthropic、OpenAI、Google、Microsoft）。

社群基準測試顯示，與自訂端點相比，Laravel MCP 將 AI 功能的整合時間縮短了 5–8 倍，且得益於開放協議，完全沒有廠商鎖定的問題。

進階技巧與常見陷阱

• 在生產伺服器中使用 Sanctum 中介層，以確保工具執行的安全性。
• 對工具呼叫實施速率限制，以防止濫用。
• 利用資源模板動態展示數據（例如 Eloquent 查詢結果）。
• 陷阱：忘記註冊路由 — 變更後務必執行 php artisan route:cache。
• 進階：結合 Laravel Boost（另一個 Laravel 官方 MCP 伺服器）以提升本地開發體驗。

結論與資源

Laravel MCP 代表 Laravel 對新興 AI 代理生態系統的官方承諾。隨著 MCP 在 2026 年的採用率增長，在您的 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 開發未來已來臨。