Laravel MCP

概述

Laravel MCP 是 Laravel 团队开发的官方包，使开发者能够直接在 Laravel 应用程序中构建**模型上下文协议（Model Context Protocol，MCP）**服务器。作为 Laravel AI 工具套件的一部分于 2025 年推出，它提供了一个流畅、原生的 Laravel 接口，用于定义服务器、工具、资源和提示，使得任何兼容 MCP 的 AI 客户端（Claude、ChatGPT、Cursor、GitHub Copilot 等）能够安全高效地与您的 Laravel 应用交互。

通过集成 Laravel MCP，应用程序能够向 AI 智能体暴露结构化能力，无需自定义 API，遵循最初由 Anthropic 引入、现由 Linux 基金会管理的开放 MCP 标准。

主要特性

• 富有表现力的服务器定义：使用属性和流畅的 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（另一个官方 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 开发未来已来。