# Laravel MCP

Laravel 官方套件，用於快速建立模型上下文協定（MCP）伺服器，讓 AI 客戶端能夠透過工具、資源與提示，與 Laravel 應用程式進行無縫互動。

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

Language: zh-TW

Category: MCP Servers

Updated: 2026-03-24

## 概述

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 安裝：

```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 驅動的開發工具**：向 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 開發未來已來臨。

## Tags

- laravel
- mcp
- ai
- php
- server
- 模型上下文協定
- 工具
- 資源
- 提示

## Sources

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